AddFontResourceExW, 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 AddFontResourceExW(
  [in] LPCWSTR 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	Windows d’Asie de l’Est : collection de polices TrueType.
.fot	Fichier de ressources TrueType.
.otf	Police PostScript OpenType.
.mmm	plusieurs fichiers de ressources de police master Type1. Il doit être utilisé avec les fichiers .pfm et .pfb.
.pfb	Tapez 1 fichier de 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 à 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 être l’une des 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. Lorsque le processus se termine, 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, peut énumérer cette police.

[in] res

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

Valeur de retour

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 n’importe quelle 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 avoir redémarré le système, la police ne sera plus chargée et peut être modifiée.

Note

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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wingdi.h (include 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