Partager via


GetCharWidth32A, fonction (wingdi.h)

La fonction GetCharWidth32 récupère les largeurs, en coordonnées logiques, des caractères consécutifs dans une plage spécifiée à partir de la police actuelle.

Syntaxe

BOOL GetCharWidth32A(
  [in]  HDC   hdc,
  [in]  UINT  iFirst,
  [in]  UINT  iLast,
  [out] LPINT lpBuffer
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[in] iFirst

Premier caractère du groupe de caractères consécutifs.

[in] iLast

Dernier caractère du groupe de caractères consécutifs, qui ne doit pas précéder le premier caractère spécifié.

[out] lpBuffer

Pointeur vers une mémoire tampon qui reçoit les largeurs de caractères, en coordonnées logiques.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

GetCharWidth32 ne peut pas être utilisé sur les polices TrueType. Pour récupérer des largeurs de caractères pour les polices TrueType, utilisez GetCharABCWidths.

La plage est inclusive ; autrement dit, les largeurs retournées incluent les largeurs des caractères spécifiés par les paramètres iFirstChar et iLastChar .

Si aucun caractère n’existe dans la police actuelle, la largeur du caractère par défaut lui est attribuée.

Exemples

Pour obtenir un exemple, consultez « Affichage de l’entrée clavier » dans Utilisation de l’entrée clavier.

Notes

L’en-tête wingdi.h définit GetCharWidth32 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

Vue d’ensemble des polices et du texte

GetCharABCWidths

GetCharABCWidthsFloat

GetCharWidthFloat