Fonction ScriptStringGetOrder (usp10.h)

Crée un tableau qui mappe une position de caractère d’origine à une position de glyphe.

Syntaxe

HRESULT ScriptStringGetOrder(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [out] UINT                   *puOrder
);

Paramètres

[in] ssa

Structure SCRIPT_STRING_ANALYSIS pour la chaîne.

[out] puOrder

Pointeur vers une mémoire tampon dans laquelle cette fonction récupère un tableau de positions de glyphes, indexées par la position du caractère d’origine. Le tableau doit avoir de la place pour au moins le nombre d’entiers indiqué par le paramètre ssa de ScriptString_pcOutChars.

Valeur retournée

Retourne S_OK en cas de réussite. La fonction retourne une valeur HRESULT différente de zéro si elle ne réussit pas. L’application peut tester la valeur de retour avec les macros SUCCEEDED et FAILED .

Remarques

Lorsque le nombre de glyphes et le nombre de caractères sont égaux, la fonction récupère un tableau qui référence chaque glyphe. Il s’agit du même traitement que celui qui se produit dans GetCharacterPlacement.

Pour utiliser cette fonction, l’application doit spécifier SSA_GLYPHS dans son appel d’origine à ScriptStringAnalyse.

Important À compter de Windows 8 : pour conserver la possibilité de s’exécuter sur Windows 7, un module qui utilise Uniscribe doit spécifier Usp10.lib avant gdi32.lib dans sa liste de bibliothèques.
 

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête usp10.h
Bibliothèque Usp10.lib
DLL Usp10.dll
Composant redistribuable Internet Explorer 5 ou version ultérieure sur Windows Me/98/95

Voir aussi

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

ScriptString_pcOutChars

Annuler l’inscription

Annuler l’inscription de fonctions