GetGlyphIndicesW, fonction (wingdi.h)

  • Article

La fonction GetGlyphIndices traduit une chaîne en tableau d’index de glyphes. La fonction peut être utilisée pour déterminer si un glyphe existe dans une police.

Syntaxe

DWORD GetGlyphIndicesW(
  [in]  HDC     hdc,
  [in]  LPCWSTR lpstr,
  [in]  int     c,
  [out] LPWORD  pgi,
  [in]  DWORD   fl
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[in] lpstr

Pointeur vers la chaîne à convertir.

[in] c

Longueur à la fois de la longueur de la chaîne pointée par lpstr et de la taille (en WORDs) de la mémoire tampon pointée par pgi.

[out] pgi

Cette mémoire tampon doit être de dimension c. En cas de retour réussi, contient un tableau d’index de glyphes correspondant aux caractères de la chaîne.

[in] fl

Spécifie comment les glyphes doivent être gérés s’ils ne sont pas pris en charge. Ce paramètre peut être la valeur suivante.

Valeur Signification
GGI_MARK_NONEXISTING_GLYPHS
 Marque les glyphes non pris en charge avec la valeur hexadécimale 0xffff.

Valeur retournée

Si la fonction réussit, elle retourne le nombre d’octets (pour la fonction ANSI) ou de WORD (pour la fonction Unicode) convertis.

Si la fonction échoue, la valeur de retour est GDI_ERROR.

Remarques

Cette fonction tente d’identifier une représentation de glyphe unique pour chaque caractère de la chaîne pointée par lpstr. Bien que cela soit utile à certaines fins de bas niveau (comme la manipulation de fichiers de police), les applications de niveau supérieur qui souhaitent mapper une chaîne à des glyphes souhaitent généralement utiliser les fonctions Uniscribe .

Notes

L’en-tête wingdi.h définit GetGlyphIndices en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
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 wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

Fonctions de police et de texte

Vue d’ensemble des polices et du texte

GetFontUnicodeRanges