Verwenden der ScriptString-Funktionen
Für eine Anwendung, die mit unformatiertem Text arbeitet, stellt Uniscribe die *ScriptString * _-Funktionen zur Verfügung. Diese Funktionen ähneln _ ExtTextOut, * DrawTextund GetTextExtent,bieten jedoch vollständige komplexe Skriptunterstützung, einschließlich caret-Platzierung. Diese Funktionen ähneln den anderen Uniscribe-Funktionen, sind aber auf die einfacheren Anforderungen der Nur-Text-Verarbeitung zugeschnitten.
In der folgenden Tabelle sind die ScriptString-Funktionen * und alle Entsprechungen in den anderen Uniscribe-Funktionen aufgeführt.
| Funktion | BESCHREIBUNG |
|---|---|
| ScriptStringAnalyse | Analysiert Nur-Text. Diese Funktion entspricht den folgenden Funktionen: |
| ScriptStringCPtoX | Ruft die x-Koordinate für eine Zeichenposition ab. Diese Funktion entspricht ScriptCPtoX. |
| ScriptStringFree | Gibt eine SCRIPT_STRING_ANALYSIS frei. |
| ScriptStringGetLogicalWidths | Konvertiert visuelle Breiten in logische Breiten. Diese Funktion entspricht ScriptGetLogicalWidths. |
| ScriptStringGetOrder | Karten Zeichen-Glyphenpositionen auf ähnliche Weise wie GetCharacterPlacement,nur zur älteren Verwendung. Diese Funktion funktioniert nicht gut mit Skripts, die mehr als ein Glyphen pro Codepunkt generieren. |
| ScriptStringOut | Zeigt Nur-Text an. Diese Funktion entspricht ScriptTextOut. |
| ScriptString_pcOutChars | Gibt einen Zeiger auf die Länge einer abgeschnittenen Nur-Text-Zeichenfolge zurück. |
| ScriptString_pLogAttr | Gibt einen Zeiger auf den Puffer logischer Attribute für eine analysierte Nur-Text-Zeichenfolge zurück. |
| ScriptString_pSize | Gibt einen Zeiger auf die Größe (Breite und Höhe) für eine analysierte Nur-Text-Zeichenfolge zurück. |
| ScriptStringValidate | Identifiziert Codepunktsequenzen, die im angegebenen Skript nicht gültig sind. Diese Funktion ist anders als ScriptGetCMap,das Codepunkte identifiziert, die nicht in einer Schriftart vorhanden sind. |
| ScriptStringXtoCP | Konvertiert eine x-Koordinate in eine Zeichenposition. Diese Funktion entspricht ScriptXtoCP. |
Um nur Nur-Text ohne Änderungen anzuzeigen, sollte eine Anwendung ScriptStringAnalyse, ScriptStringOutund dann ScriptStringFree aufrufen. Die anderen Funktionen werden verwendet, um den Nur-Text vor der Anzeige zu ändern.