ScriptStringGetOrder-Funktion (usp10.h)

Artikel
08/26/2023

Erstellt ein Array, das eine ursprüngliche Zeichenposition einer Glyphenposition zuordnet.

Syntax

HRESULT ScriptStringGetOrder(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [out] UINT                   *puOrder
);

Parameter

[in] ssa

Eine SCRIPT_STRING_ANALYSIS-Struktur für die Zeichenfolge.

[out] puOrder

Zeiger auf einen Puffer, in dem diese Funktion ein Array von Glyphenpositionen abruft, die anhand der ursprünglichen Zeichenposition indiziert sind. Das Array sollte über mindestens die Anzahl von ganzen Zahlen verfügen, die durch den ssa-Parametervon ScriptString_pcOutChars angegeben werden.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Die Funktion gibt einen nichtzero-HRESULT-Wert zurück, wenn er nicht erfolgreich ist. Die Anwendung kann den Rückgabewert mit den Makros SUCCEEDED und FAILED testen.

Hinweise

Wenn die Anzahl der Glyphen und die Anzahl der Zeichen gleich sind, ruft die Funktion ein Array ab, das auf jede Glyphe verweist. Dies ist die gleiche Behandlung wie in GetCharacterPlacement.

Um diese Funktion verwenden zu können, muss die Anwendung SSA_GLYPHS in ihrem ursprünglichen Aufruf von ScriptStringAnalyse angeben.

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 seiner Bibliotheksliste angeben.

Anforderungen


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