ScriptStringXtoCP-Funktion (usp10.h)
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.
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 |