ScriptStringXtoCP-Funktion (usp10.h)

Artikel
08/26/2023

Konvertiert eine x-Koordinate in eine Zeichenposition.

Syntax

HRESULT ScriptStringXtoCP(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [in]  int                    iX,
  [out] int                    *piCh,
  [out] int                    *piTrailing
);

Parameter

[in] ssa

Eine SCRIPT_STRING_ANALYSIS-Struktur für die Zeichenfolge.

[in] iX

Die x-Koordinate.

[out] piCh

Zeiger auf eine Variable, in der diese Funktion die Zeichenposition abruft, die der x-Koordinate entspricht.

[out] piTrailing

Zeiger auf eine Variable, in der diese Funktion einen Wert abruft, der angibt, ob die x-Koordinate für die führende Kante oder die nachfolgende Kante der Zeichenposition ist. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

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 x-Koordinate dem führenden Rand des Zeichens entspricht, ist der Wert von piTrailing 0. Wenn die x-Koordinate dem nachfolgenden Rand des Zeichens entspricht, ist der Wert von piTrailing eine positive ganze Zahl. Wie für ScriptXtoCP ist der Wert 1 für ein Zeichen, das selbst gerendert werden kann. Der Wert ist größer als 1, wenn das Zeichen Teil eines Clusters in einem Skript ist, für das Cursor nicht in einem Cluster platziert werden, um den Offset auf die nächste legitime position des logischen Cursors anzugeben.

Wenn sich die x-Koordinate vor dem Anfang der Zeile befindet, ruft die Funktion -1 für piCh und 1 für piTrailing ab, wodurch die nachfolgende Kante des nicht vorhandenen Zeichens vor der Zeile angegeben wird. Wenn sich die x-Koordinate nach dem Ende der Zeile befindet, ruft die Funktion für piCh den ersten Index ab, der über die Länge der Zeile hinaus liegt, und 0 für piTrailing. Der Wert 0 gibt die führende Kante des nicht vorhandenen Zeichens nach der Zeile an.

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

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

Weitere Informationen

SCRIPT_STRING_ANALYSIS

Uniscribe

Uniscribe Functions

Share via