GetFontData, fonction (wingdi.h)

  • Article

La fonction GetFontData récupère les données de métrique de police pour une police TrueType.

Syntaxe

DWORD GetFontData(
  [in]  HDC   hdc,
  [in]  DWORD dwTable,
  [in]  DWORD dwOffset,
  [out] PVOID pvBuffer,
  [in]  DWORD cjBuffer
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

[in] dwTable

Nom d’une table de métriques de polices à partir de laquelle les données de police doivent être récupérées. Ce paramètre peut identifier l’une des tables de métriques documentées dans la spécification TrueType Font Files publiée par Microsoft Corporation. Si ce paramètre est égal à zéro, les informations sont récupérées à partir du début du fichier pour les fichiers de police TrueType ou du début des données de la police actuellement sélectionnée pour les fichiers de la collection TrueType. Pour récupérer les données du début du fichier pour les fichiers de collection TrueType, spécifiez « ttcf » (0x66637474).

[in] dwOffset

Décalage entre le début de la table de métriques de polices et l’emplacement où la fonction doit commencer à récupérer des informations. Si ce paramètre est égal à zéro, les informations sont récupérées à partir du début de la table spécifiée par le paramètre dwTable . Si cette valeur est supérieure ou égale à la taille de la table, une erreur se produit.

[out] pvBuffer

Pointeur vers une mémoire tampon qui reçoit les informations de police. Si ce paramètre a la valeur NULL, la fonction retourne la taille de la mémoire tampon requise pour les données de police.

[in] cjBuffer

Longueur, en octets, des informations à récupérer. Si ce paramètre est égal à zéro, GetFontData retourne la taille des données spécifiées dans le paramètre dwTable .

Valeur retournée

Si la fonction réussit, la valeur renvoyée est le nombre d’octets retournés.

Si la fonction échoue, la valeur de retour est GDI_ERROR.

Remarques

Cette fonction est destinée à être utilisée pour récupérer des informations de police TrueType directement à partir du fichier de polices par des applications de manipulation de police. Pour plus d’informations sur l’incorporation de polices, consultez la référence sur l’incorporation de polices.

Une application peut parfois utiliser la fonction GetFontData pour enregistrer une police TrueType avec un document. Pour ce faire, l’application détermine si la police peut être incorporée en vérifiant le membre otmfsType de la structure OUTLINETEXTMETRIC . Si le bit 1 de otmfsType est défini, l’incorporation n’est pas autorisée pour la police. Si le bit 1 est clair, la police peut être incorporée. Si le bit 2 est défini, l’incorporation est en lecture seule. Si l’incorporation est autorisée, l’application peut récupérer l’intégralité du fichier de police, en spécifiant zéro pour les paramètres dwTable, dwOffset et cbData .

Si une application tente d’utiliser cette fonction pour récupérer des informations pour une police non TrueType, une erreur se produit.

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