GetGlyphIndicesA, fonction (wingdi.h)

Article
11/20/2024

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

Syntaxe

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

Paramètres

[in] hdc

Handle vers le contexte de l’appareil.

[in] lpstr

Pointeur vers la chaîne à convertir.

[in] c

Longueur de la longueur de la chaîne pointée par lpstr et la taille (en WORD) 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 glyphe 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 de retour

Si la fonction réussit, elle retourne le nombre d’octets (pour la fonction ANSI) ou les 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 (telles que 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.

Note

L’en-tête wingdi.h définit GetGlyphIndices comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wingdi.h (include 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

Partager via