GetOutlineTextMetricsA, fonction (wingdi.h)

  • Article

La fonction GetOutlineTextMetrics récupère les métriques de texte pour les polices TrueType.

Syntaxe

UINT GetOutlineTextMetricsA(
  [in]            HDC                  hdc,
  [in]            UINT                 cjCopy,
  [out, optional] LPOUTLINETEXTMETRICA potm
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[in] cjCopy

Taille, en octets, du tableau qui reçoit les métriques de texte.

[out, optional] potm

Pointeur vers une structure OUTLINETEXTMETRIC . Si ce paramètre a la valeur NULL, la fonction retourne la taille de la mémoire tampon requise pour les données de métriques récupérées.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro ou de la taille de la mémoire tampon requise.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

La structure OUTLINETEXTMETRIC contient la plupart des informations de métriques de texte fournies pour les polices TrueType (y compris une structure TEXTMETRIC ). Les tailles retournées dans OUTLINETEXTMETRIC sont en unités logiques ; elles dépendent du mode de mappage actuel.

Notes

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

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

Voir aussi

Fonctions de police et de texte

Vue d’ensemble des polices et du texte

GetTextMetrics

OUTLINETEXTMETRIC

TEXTMETRIC