AddFontMemResourceEx, fonction (wingdi.h)
La fonction AddFontMemResourceEx ajoute la ressource de police d’une image mémoire au système.
Syntaxe
HANDLE AddFontMemResourceEx(
[in] PVOID pFileView,
[in] DWORD cjSize,
[in] PVOID pvResrved,
[in] DWORD *pNumFonts
);
Paramètres
[in] pFileView
Pointeur vers une ressource de police.
[in] cjSize
Nombre d’octets dans la ressource de police pointée par pbFont.
[in] pvResrved
Réservé. Doit être égal à 0.
[in] pNumFonts
Pointeur vers une variable qui spécifie le nombre de polices installées.
Valeur retournée
Si la fonction réussit, la valeur de retour spécifie le handle à la police ajoutée. Ce handle identifie de manière unique les polices qui ont été installées sur le système. Si la fonction échoue, la valeur de retour est égale à zéro. Aucune information d’erreur étendue n’est disponible.
Remarques
Cette fonction permet à une application d’obtenir une police incorporée dans un document ou une page web. Une police ajoutée par AddFontMemResourceEx est toujours privée au processus qui a effectué l’appel et n’est pas énumérable.
Une image mémoire peut contenir plusieurs polices. Lorsque cette fonction réussit, pcFonts est un pointeur vers un DWORD dont la valeur est le nombre de polices ajoutées au système à la suite de cet appel. Par exemple, ce nombre peut être 2 pour les visages verticaux et horizontaux d’une police asiatique.
Lorsque la fonction réussit, l’appelant de cette fonction peut libérer la mémoire pointée par pbFont , car le système a fait sa propre copie de la mémoire. Pour supprimer les polices installées, appelez RemoveFontMemResourceEx. Toutefois, lorsque le processus disparaît, le système décharge les polices même si le processus n’a pas appelé RemoveFontMemResource.
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 |