GetGlyphIndicesA, fonction (wingdi.h)
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 GetGlyphIndicesA(
[in] HDC hdc,
[in] LPCSTR 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 |
|---|---|
|
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
| 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