GetCharWidthI, fonction (wingdi.h)

Article
08/27/2023

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

Syntaxe

BOOL GetCharWidthI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPINT  piWidths
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] giFirst

Premier index de glyphe dans le groupe d’index de glyphes consécutifs.

[in] cgi

Nombre d’index de glyphes.

[in] pgi

Pointeur vers un tableau d’index de glyphes. Si ce paramètre n’est pas NULL, il est utilisé à la place du paramètre giFirst .

[out] piWidths

Pointeur vers une mémoire tampon qui reçoit les largeurs, 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

La fonction GetCharWidthI traite un index de glyphe consécutif si le paramètre pgi a la valeur NULL , le paramètre giFirst indiquant le premier index de glyphe à traiter et le paramètre cgi indiquant le nombre d’index de glyphes à traiter. Sinon, la fonction GetCharWidthI traite le tableau d’index de glyphes pointés par le paramètre pgi avec le paramètre cgi indiquant le nombre d’index de glyphes à traiter.

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

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