GetCharWidthW, fonction (wingdi.h)

Article
11/20/2024

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

Remarque Cette fonction est fournie uniquement pour la compatibilité avec les versions 16 bits de Windows. Les applications doivent appeler la fonction GetCharWidth32, qui fournit des résultats plus précis.

Syntaxe

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

Paramètres

[in] hdc

Handle vers 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 de retour

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

getCharWidth 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 un caractère n’existe pas dans la police actuelle, il est affecté à la largeur du caractère par défaut.

Note

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