Funzione ScriptIsComplex (usp10.h)

Articolo
03/03/2024

Determina se una stringa Unicode richiede un'elaborazione di script complessa.

Sintassi

HRESULT ScriptIsComplex(
  [in] const WCHAR *pwcInChars,
  [in] int         cInChars,
  [in] DWORD       dwFlags
);

Parametri

[in] pwcInChars

Puntatore alla stringa da testare.

[in] cInChars

Lunghezza della stringa di input, in caratteri.

[in] dwFlags

Flag che specificano i dettagli del test. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
SIC_ASCIIDIGIT	Considera le cifre da U+0030 a U+0039 come complesse. L'applicazione imposta questo flag se la stringa viene visualizzata con la sostituzione delle cifre abilitata. Se l'applicazione segue le impostazioni NLS (National Language Support) dell'utente usando la funzione ScriptRecordDigitSubstitution , può passare una struttura SCRIPT_DIGITSUBSTITUTE con il membro DigitSubstitute impostato su SCRIPT_DIGITSUBSTITUTE_NONE.
SIC_COMPLEX	Considerare le lettere di script complesse come complesse. Questo flag deve essere normalmente impostato.
SIC_NEUTRAL	Considerare i neutrali come complessi. L'applicazione imposta questo flag per visualizzare la stringa con ordine di lettura da destra a sinistra.

Valore restituito

Restituisce S_OK se la stringa richiede un'elaborazione di script complessa. La funzione restituisce S_FALSE se la stringa può essere gestita da chiamate di funzione API standard, ovvero contiene solo caratteri disposti side-by-side e da sinistra a destra. Se non ha esito positivo, la funzione restituisce un valore HRESULT diverso da zero.

Commenti

Per informazioni sul contesto in cui questa funzione viene normalmente chiamata, vedere Visualizzazione di testo con Uniscribe .

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 di 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
Componente ridistribuibile	Internet Explorer 5 o versione successiva in Windows Me/98/95

Vedi anche

Visualizzazione di testo con Uniscribe

SCRIPT_DIGITSUBSTITUTE

ScriptRecordDigitSubstitution

Uniscribe

Funzioni Uniscribe

Condividi tramite