Partager via


GetOutlineTextMetricsA, fonction (wingdi.h)

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 vers 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 est NULL, la fonction retourne la taille de la mémoire tampon requise pour les données de métrique récupérées.

Valeur de retour

Si la fonction réussit, la valeur de retour est différente de zéro ou 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étrique 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.

Note

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. 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Windows
d’en-tête wingdi.h (include 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