Delen via


De ScriptString-functies gebruiken

Voor een toepassing die te maken heeft met niet-opgemaakte tekst, biedt Uniscribe de functies ScriptString*. Deze functies zijn vergelijkbaar met ExtTextOut-, DrawTexten GetTextExtent-, maar bieden volledige ondersteuning voor complexe scripts, waaronder caret-plaatsing. Deze functies zijn vergelijkbaar met de andere Uniscribe-functies, maar zijn afgestemd op de eenvoudigere vereisten voor verwerking van tekst zonder opmaak.

In de volgende tabel worden de functies ScriptString* en eventuele tegenhangers in de andere uniscribe-functies beschreven.

Functie Beschrijving
ScriptStringAnalyse- Analyseert tekst zonder opmaak. Deze functie komt overeen met de volgende functies:
ScriptItemize
ScriptShape
ScriptPlace
ScriptBreak
ScriptGetCMap-
ScriptJustify
ScriptLayout
ScriptStringCPtoX Haalt de x-coördinaat voor een tekenpositie op. Deze functie komt overeen met ScriptCPtoX-.
ScriptStringFree Er wordt een SCRIPT_STRING_ANALYSIS structuur vrijgemaakt.
ScriptStringGetLogicalWidths Converteert visuele breedten naar logische breedten. Deze functie komt overeen met ScriptGetLogicalWidths.
ScriptStringGetOrder-functie Hiermee wijst teken-glyph posities op vergelijkbare wijze toe als GetCharacterPlacement, alleen voor verouderd gebruik. Deze functie werkt niet goed met scripts die meer dan één glyph per codepunt genereren.
ScriptStringOut Hiermee wordt tekst zonder opmaak weergegeven. Deze functie komt overeen met ScriptTextOut-.
ScriptString_pcOutChars Retourneert een aanwijzer naar de lengte van een geclipte tekstreeks zonder opmaak.
ScriptString_pLogAttr Retourneert een aanwijzer naar de buffer voor logische kenmerken voor een geanalyseerde platte teksttekenreeks.
ScriptString_pSize Retourneert een aanwijzer naar de grootte (breedte en hoogte) voor een geanalyseerde platte tekst.
ScriptStringValidate Identificeert codepuntreeksen die niet geldig zijn in het opgegeven script. Deze functie verschilt van ScriptGetCMap, waarmee codepunten worden geïdentificeerd die niet aanwezig zijn in een lettertype.
ScriptStringXtoCP Converteert een x-coördinaat naar een tekenpositie. Deze functie komt overeen met ScriptXtoCP-.

Een toepassing zou ScriptStringAnalysemoeten aanroepen om alleen platte tekst zonder wijzigingen weer te geven, vervolgens ScriptStringOuten daarna ScriptStringFree. De andere functies worden gebruikt om de tekst zonder opmaak te wijzigen voordat deze wordt weergegeven.

Gebruik van Uniscribe