GetTextMetricsA, fonction (wingdi.h)
La fonction GetTextMetrics remplit la mémoire tampon spécifiée avec les métriques de la police actuellement sélectionnée.
Syntaxe
BOOL GetTextMetricsA(
[in] HDC hdc,
[out] LPTEXTMETRICA lptm
);
Paramètres
[in] hdc
Handle dans 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 des entrées clavier » dans Utilisation d’une entrée clavier ou dessin de texte à partir de différentes polices sur la même ligne.
Notes
L’en-tête wingdi.h définit GetTextMetrics comme un 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.
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 |