Fonction ScriptStringGetOrder (usp10.h)

Article
08/26/2023

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