GetTextExtentPointI, fonction (wingdi.h)

Article
03/08/2023

La fonction GetTextExtentPointI calcule la largeur et la hauteur du tableau spécifié d’index de glyphes.

Syntaxe

BOOL GetTextExtentPointI(
  [in]  HDC    hdc,
  [in]  LPWORD pgiIn,
  [in]  int    cgi,
  [out] LPSIZE psize
);

Paramètres

[in] hdc

Gérez le contexte de l’appareil.

[in] pgiIn

Pointeur vers le tableau d’index de glyphes.

[in] cgi

Spécifie le nombre d’index de glyphes.

[out] psize

Pointeur vers une structure SIZE qui reçoit les dimensions de la chaîne, en unités 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 GetTextExtentPointI utilise la police actuellement sélectionnée pour calculer les dimensions du tableau d’index de glyphes. La largeur et la hauteur, en unités logiques, sont calculées sans tenir compte de la coupure.

Lorsque cette fonction retourne l’étendue du texte, elle suppose que le texte est horizontal, c’est-à-dire que l’échappement est toujours 0. Cela est vrai pour les mesures horizontales et verticales du texte. Même si vous utilisez une police qui spécifie un échappement différent de zéro, cette fonction n’utilise pas l’angle pendant qu’elle calcule l’étendue du texte. L’application doit la convertir explicitement. Toutefois, lorsque le mode graphique est défini sur GM_ADVANCED et que l’orientation des caractères est à 90 degrés de l’orientation d’impression, les valeurs retournées par cette fonction ne suivent pas cette règle. Lorsque l’orientation des caractères et l’orientation d’impression correspondent pour une chaîne donnée, cette fonction retourne les dimensions de la chaîne dans la structure SIZE sous la forme { cx : 116, cy : 18 }. Lorsque l’orientation des caractères et l’orientation d’impression sont séparées de 90 degrés pour la même chaîne, cette fonction retourne les dimensions de la chaîne dans la structure SIZE comme { cx : 18, cy : 116 }.

Étant donné que certains appareils caractères de kern, la somme des étendues des indices de glyphes individuels peut ne pas être égale à l’étendue de l’ensemble du tableau d’index de glyphes.

La largeur de chaîne calculée prend en compte l’espacement entre les caractères définis par la fonction SetTextCharacterExtra .

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