RemoveFontResourceExA, fonction (wingdi.h)
La fonction RemoveFontResourceEx supprime les polices du fichier spécifié de la table de polices système.
Syntaxe
BOOL RemoveFontResourceExA(
[in] LPCSTR name,
[in] DWORD fl,
[in] PVOID pdv
);
Paramètres
[in] name
Pointeur vers une chaîne terminée par null qui nomme un fichier de ressources de police.
[in] fl
Caractéristiques de la police à supprimer du système. Pour que la police soit supprimée, les indicateurs utilisés doivent être identiques au moment où la police a été ajoutée avec la fonction AddFontResourceEx. Pour plus d’informations, consultez la fonction AddFontResourceEx.
[in] pdv
Réservé. Doit être égal à zéro.
Valeur de retour
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Aucune information d’erreur étendue n’est disponible.
Remarques
Cette fonction supprime uniquement la police si les indicateurs spécifiés sont identiques au moment où la police a été ajoutée avec la fonction AddFontResourceEx.
Lorsque vous essayez de remplacer un fichier de police existant qui contient une police avec des références en attente, vous pouvez obtenir une erreur indiquant que la police d’origine ne peut pas être supprimée, car elle est en cours d’utilisation même après avoir appelé RemoveFontResourceEx. Si votre application exige que le fichier de police soit remplacé, pour réduire le nombre de ressources de la police d’origine à zéro, appelez RemoveFontResourceEx dans une boucle, comme illustré dans cet exemple de code. Si vous continuez à obtenir des erreurs, il s’agit d’une indication que le fichier de police reste chargé dans d’autres sessions. Vérifiez que la police n’est pas répertoriée dans le Registre de polices et redémarrez le système pour vous assurer que la police est déchargée de toutes les sessions.
int i = 0;
while( RemoveFontResourceEx( FontFile, FR_PRIVATE, 0 ) )
{
i++;
}
// TODO: Replace font file
while( i-- )
{
AddFontResourceEx( FontFile, FR_PRIVATE, 0 );
}
Note
L’en-tête wingdi.h définit RemoveFontResourceEx 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