ScriptIsComplex-Funktion (usp10.h)

Artikel
03/03/2024

Bestimmt, ob eine Unicode-Zeichenfolge eine komplexe Skriptverarbeitung erfordert.

Syntax

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

Parameter

[in] pwcInChars

Zeiger auf die zu testde Zeichenfolge.

[in] cInChars

Länge der Eingabezeichenfolge in Zeichen.

[in] dwFlags

Flags, die Testdetails angeben. Dieser Parameter kann einen der folgenden Werte aufweisen.

Wert	Bedeutung
SIC_ASCIIDIGIT	Behandeln Sie die Ziffern U+0030 bis U+0039 als komplex. Die Anwendung legt dieses Flag fest, wenn die Zeichenfolge mit aktivierter Ziffernersetzung angezeigt wird. Wenn die Anwendung mithilfe der ScriptRecordDigitSubstitution-Funktion den NLS-Einstellungen (National Language Support) des Benutzers folgt, kann sie eine SCRIPT_DIGITSUBSTITUTE-Struktur übergeben, deren DigitSubstitute-Member auf SCRIPT_DIGITSUBSTITUTE_NONE festgelegt ist.
SIC_COMPLEX	Behandeln Sie komplexe Skriptbuchstaben als komplex. Dieses Flag sollte normalerweise festgelegt werden.
SIC_NEUTRAL	Neutrale als komplex behandeln. Die Anwendung legt dieses Flag fest, um die Zeichenfolge mit Leserichtung von rechts nach links anzuzeigen.

Rückgabewert

Gibt S_OK zurück, wenn die Zeichenfolge eine komplexe Skriptverarbeitung erfordert. Die Funktion gibt S_FALSE zurück, wenn die Zeichenfolge von Api-Standardfunktionsaufrufen verarbeitet werden kann, d. h., sie enthält nur Zeichen, die nebeneinander und von links nach rechts angeordnet sind. Die Funktion gibt einen HRESULT-Wert ungleich null zurück, wenn sie nicht erfolgreich ist.

Hinweise

Eine Erläuterung des Kontexts, in dem diese Funktion normalerweise aufgerufen wird, finden Sie unter Anzeigen von Text mit Uniscribe .

Wichtig Ab Windows 8: Um die Ausführung unter Windows 7 zu gewährleisten, muss ein Modul, das Uniscribe verwendet, Usp10.lib vor gdi32.lib in der Bibliotheksliste angeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	usp10.h
Bibliothek	Usp10.lib
DLL	Usp10.dll
Verteilbare Komponente	Internet Explorer 5 oder höher unter Windows Me/98/95