AddFontResourceExA, fonction (wingdi.h)

La fonction AddFontResourceEx ajoute la ressource de police du fichier spécifié au système. Les polices ajoutées avec la fonction AddFontResourceEx peuvent être marquées comme privées et non énumérables.

Syntaxe

int AddFontResourceExA(
  [in] LPCSTR name,
  [in] DWORD  fl,
  [in] PVOID  res
);

Paramètres

[in] name

Pointeur vers une chaîne de caractères terminée par null qui contient un nom de fichier de police valide. Ce paramètre peut spécifier l’un des fichiers suivants.

Extension de fichier	Signification
.Fon	Fichier de ressources de police.
.Fnt	Fichier de police bitmap brut.
.ttf	Fichier TrueType brut.
.Ttc	Fenêtres d’Asie de l’Est : collection de polices TrueType.
.Fot	Fichier de ressources TrueType.
.Fto	Police OpenType PostScript.
.mmm	plusieurs master fichier de ressources de police Type1. Il doit être utilisé avec les fichiers .pfm et .pfb.
.Pfb	Tapez 1 fichier bits de police. Il est utilisé avec un fichier .pfm.
.Pfm	Tapez 1 fichier de métriques de police. Il est utilisé avec un fichier .pfb.

 

Pour ajouter une police dont les informations proviennent de plusieurs fichiers de ressources, pointez lpszFileName sur une chaîne avec les noms de fichiers séparés par un | --par exemple, abcxxxxx.pfm | abcxxxxx.pfb.

[in] fl

Caractéristiques de la police à ajouter au système. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
FR_PRIVATE	Spécifie que seul le processus qui a appelé la fonction AddFontResourceEx peut utiliser cette police. Lorsque le nom de la police correspond à une police publique, la police privée est choisie. À l’arrêt du processus, le système supprime toutes les polices installées par le processus avec la fonction AddFontResourceEx .
FR_NOT_ENUM	Spécifie qu’aucun processus, y compris le processus qui a appelé la fonction AddFontResourceEx , ne peut énumérer cette police.

[in] res

Réservé. Doit être zéro.

Valeur retournée

Si la fonction réussit, la valeur de retour spécifie le nombre de polices ajoutées.

Si la fonction échoue, la valeur de retour est égale à zéro. Aucune information d’erreur étendue n’est disponible.

Remarques

Cette fonction permet à un processus d’utiliser des polices sans autoriser d’autres processus à accéder aux polices.

Lorsqu’une application n’a plus besoin d’une ressource de police qu’elle a chargée en appelant la fonction AddFontResourceEx , elle doit supprimer la ressource en appelant la fonction RemoveFontResourceEx .

Cette fonction installe la police uniquement pour la session active. Lorsque le système redémarre, la police n’est pas présente. Pour que la police soit installée même après le redémarrage du système, la police doit être répertoriée dans le Registre.

Une police répertoriée dans le Registre et installée à un emplacement autre que le dossier %windir%\fonts\ ne peut pas être modifiée, supprimée ou remplacée tant qu’elle est chargée dans une session. Pour modifier l’une de ces polices, elle doit d’abord être supprimée en appelant RemoveFontResource, supprimée du registre de polices (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts) et le système redémarré. Après le redémarrage du système, la police n’est plus chargée et peut être modifiée.

Notes

L’en-tête wingdi.h définit AddFontResourceEx 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. La combinaison 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.

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

RemoveFontResourceEx

SendMessage