Funzione ScriptStringOut (usp10.h)

Articolo
08/26/2023

Visualizza una stringa generata da una chiamata precedente a ScriptStringAnalyse e facoltativamente aggiunge l'evidenziazione.

Sintassi

HRESULT ScriptStringOut(
  [in]           SCRIPT_STRING_ANALYSIS ssa,
  [in]           int                    iX,
  [in]           int                    iY,
  [in]           UINT                   uOptions,
  [in, optional] const RECT             *prc,
  [in]           int                    iMinSel,
  [in]           int                    iMaxSel,
  [in]           BOOL                   fDisabled
);

Parametri

[in] ssa

Struttura SCRIPT_STRING_ANALYSIS per la stringa.

[in] iX

Coordinata x del punto di riferimento utilizzata per posizionare la stringa.

[in] iY

Coordinata y del punto di riferimento usato per posizionare la stringa.

[in] uOptions

Opzioni che specificano l'uso del rettangolo definito dall'applicazione. Questo parametro può essere impostato su 0 o su uno dei valori seguenti. I valori possono essere combinati con l'OR binario.

Valore	Significato
ETO_CLIPPED	Ritagliare il testo nel rettangolo.
ETO_OPAQUE	Usare il colore di sfondo corrente per riempire il rettangolo.

[in, optional] prc

Puntatore a una struttura RECT che definisce il rettangolo da usare. Se uOptions è impostato su ETO_OPAQUE e NULL viene fornito per la prc, la funzione ha esito positivo e restituisce S_OK. Tuttavia, se l'applicazione imposta uOptions su ETO_CLIPPING e fornisce NULL per prc, la funzione restituisce E_INVALIDARG. L'applicazione può impostare questo parametro su NULL per indicare che non è necessaria alcuna opzione.

[in] iMinSel

Indice in base zero che specifica la posizione iniziale nella stringa. Per nessuna selezione, l'applicazione deve impostare iMinSel= iMaxSel>.

[in] iMaxSel

Indice in base zero che specifica la posizione finale nella stringa.

[in] fDisabled

TRUE se il sistema operativo applica l'evidenziazione del testo disabilitato impostando il colore di sfondo su COLOR_HIGHLIGHT dietro tutti i caratteri selezionati. L'applicazione può impostare questo parametro su FALSE se il sistema operativo applica l'evidenziazione del testo abilitato impostando il colore di sfondo su COLOR_HIGHLIGHT e sul colore del testo su COLOR_HIGHLIGHTTEXT per ogni carattere selezionato.

Valore restituito

Restituisce S_OK se riuscito. La funzione restituisce un valore HRESULT diverso da zero se non riesce. L'applicazione non può testare il valore restituito con le macro SUCCESSED e FAILED .

Commenti

Per usare questa funzione, l'applicazione deve specificare SSA_GLYPHS nella chiamata originale a ScriptStringAnalyse.

L'applicazione non deve usare SetTextAlign con TA_UPDATECP quando si usa ScriptStringOut perché il testo selezionato non può essere eseguito correttamente. Se l'applicazione deve usare questo flag, può annullare e reimpostare il flag in base alle esigenze per evitare il problema.

Importante A partire da Windows 8: per mantenere la possibilità di eseguire in Windows 7, un modulo che usa Uniscribe deve specificare Usp10.lib prima di gdi32.lib nell'elenco delle librerie.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	usp10.h
Libreria	Usp10.lib
DLL	Usp10.dll

Vedi anche

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

Uniscribe

Funzioni uniscrivere

Condividi tramite