Utilisation des fonctions ScriptString
Pour une application traitant du texte non mis en forme, Uniscribe fournit les fonctions ScriptString* . Ces fonctions sont similaires à ExtTextOut, DrawText et GetTextExtent, mais elles fournissent une prise en charge complète des scripts complexes, y compris le placement de caret. Ces fonctions sont similaires aux autres fonctions Uniscribe, mais sont adaptées aux exigences plus simples du traitement de texte brut.
Le tableau suivant détaille les fonctions ScriptString* et tous les équivalents dans les autres fonctions Uniscribe.
| Fonction | Description |
|---|---|
| ScriptStringAnalyse | Analyse le texte brut. Cette fonction correspond aux fonctions suivantes : |
| ScriptStringCPtoX | Récupère la coordonnée x pour une position de caractère. Cette fonction correspond à ScriptCPtoX. |
| ScriptStringFree | Libère une structure SCRIPT_STRING_ANALYSIS . |
| ScriptStringGetLogicalWidths | Convertit les largeurs visuelles en largeurs logiques. Cette fonction correspond à ScriptGetLogicalWidths. |
| ScriptStringGetOrder | Mappe les positions de glyphe de caractères de la même manière que GetCharacterPlacement, pour une utilisation héritée uniquement. Cette fonction ne fonctionne pas correctement avec les scripts qui génèrent plusieurs glyphes par point de code. |
| ScriptStringOut | Affiche du texte brut. Cette fonction correspond à ScriptTextOut. |
| ScriptString_pcOutChars | Retourne un pointeur vers la longueur d’une chaîne de texte brut clippée. |
| ScriptString_pLogAttr | Retourne un pointeur vers la mémoire tampon d’attributs logiques pour une chaîne de texte brut analysée. |
| ScriptString_pSize | Retourne un pointeur vers la taille (largeur et hauteur) d’une chaîne de texte brut analysée. |
| ScriptStringValidate | Identifie les séquences de points de code non valides dans le script donné. Cette fonction est différente de ScriptGetCMap, qui identifie les points de code non présents dans une police. |
| ScriptStringXtoCP | Convertit une coordonnée x en position de caractère. Cette fonction correspond à ScriptXtoCP. |
Pour afficher uniquement du texte brut sans aucune modification, une application doit appeler ScriptStringAnalyse, ScriptStringOut, puis ScriptStringFree. Les autres fonctions sont utilisées pour modifier le texte brut avant l’affichage.
Rubriques connexes