CDC::GetFontData

Article
03/04/2013

Récupère les polices informations métriques à partir d'un fichier de police évolutif.

DWORD GetFontData(
   DWORD dwTable,
   DWORD dwOffset,
   LPVOID lpData,
   DWORD cbData 
) const;

Paramètres

dwTable
Spécifie le nom de la table métriques à retourner.Ce paramètre peut avoir l'une des tables métriques documentés dans la spécification de fichiers fontes de polices TrueType publié par Microsoft Corporation.Si ce paramètre est 0, les informations sont démarrer extrait au début du fichier de police.
dwOffset
Spécifie l'offset du début du tableau auquel démarrer la récupération des informations.Si ce paramètre est 0, les informations sont démarrer extrait au début du tableau spécifié par le paramètre d' dwTable .Si cette valeur est supérieure ou égale à la taille du tableau, retourne 0 d' GetFontData .
lpData
Pointe vers une mémoire tampon qui recevra les informations de police.Si cette valeur est NULL, la fonction retourne la taille de la mémoire tampon requise pour les données de police spécifié dans le paramètre d' dwTable .
cbData
Spécifie la durée, en octets, des informations à récupérer.Si ce paramètre est 0, GetFontData retourne la taille des données spécifiés dans le paramètre d' dwTable .

Valeur de retour

Spécifie le nombre d'octets retournés dans la mémoire tampon pointée pointe vers lpData si la fonction est réussie ; sinon – 1.

Notes

Les informations à récupérer sont identifiées en spécifiant un offset dans le fichier de police et la longueur des informations à retourner.

Une application peut parfois utiliser la fonction membre d' GetFontData pour enregistrer une police TrueType à un document.Pour ce faire, l'application détermine si la police peut être incorporée puis récupère le fichier de police entier, en spécifiant 0 pour dwTable, dwOffset, et paramètres d' cbData .

Les applications peuvent déterminer si une police peut être incorporée en vérifiant le membre d' otmfsType de la structure d' OUTLINETEXTMETRIC .Si les plateformes 1 bits d' otmfsType est défini, l'incorporation n'est pas autorisé pour la police.Si les plateformes 1 bits est clair, la police peut être incorporée.Si les plateformes 2 bits est défini, l'incorporation est en lecture seule.

Si les une application tente d'utiliser cette fonction pour extraire des informations pour une police non TrueType, la fonction membre d' GetFontData retourne à 1.