GetTextMetrics, fonction (wingdi.h)

Article
03/04/2024

La fonction GetTextMetrics remplit la mémoire tampon spécifiée avec les métriques de la police actuellement sélectionnée.

Syntaxe

BOOL GetTextMetrics(
  [in]  HDC          hdc,
  [out] LPTEXTMETRIC lptm
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[out] lptm

Pointeur vers la structure TEXTMETRIC qui reçoit les métriques de texte.

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

Pour déterminer si une police est une police TrueType, commencez par la sélectionner dans un contrôleur de domaine, puis appelez GetTextMetrics, puis case activée pour TMPF_TRUETYPE dans TEXTMETRIC.tmPitchAndFamily. Notez que GetDC retourne un contrôleur de domaine non initialisé, qui a « System » (une police bitmap) comme police par défaut ; par conséquent, la nécessité de sélectionner une police dans le contrôleur de domaine.

Exemples

Pour obtenir un exemple, consultez « Affichage de l’entrée clavier » dans Utilisation d’une entrée clavier ou dessin de texte à partir de différentes polices sur la même ligne.

Configuration requise

Condition requise	Valeur
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