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 :
ScriptItemize
ScriptShape
ScriptPlace
ScriptBreak
ScriptGetCMap
ScriptJustify
ScriptLayout
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.

Utilisation d’Uniscribe