GetFontData, fonction (wingdi.h)
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