AddFontResourceA, fonction (wingdi.h)

La fonction AddFontResource ajoute la ressource de police du fichier spécifié à la table de polices système. La police peut ensuite être utilisée pour la sortie de texte par n’importe quelle application.

Pour marquer une police comme privée ou non énumérable, utilisez la fonction AddFontResourceEx.

Syntaxe

int AddFontResourceA(
  [in] LPCSTR unnamedParam1
);

Paramètres

[in] unnamedParam1

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	Fichier de ressource de police Type1 principal multiple. 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, lpszFileName pointer vers une chaîne avec les noms de fichiers séparés par un « | » --par exemple, abcxxxxx.pfm | abcxxxxx.pfb.

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

Toute application qui ajoute ou supprime des polices de la table de polices système doit notifier d’autres fenêtres de la modification en envoyant un message WM_FONTCHANGE à toutes les fenêtres de niveau supérieur du système d’exploitation. L’application doit envoyer ce message en appelant la fonction SendMessage et en définissant le paramètre hwnd sur HWND_BROADCAST.

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

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 AddFontResource 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

AddFontResourceEx

fonctions de police et de texte

Vue d’ensemble des polices et du texte

RemoveFontResource

SendMessage