EnumFontsA, fonction (wingdi.h)

Article
03/13/2024

La fonction EnumFonts énumère les polices disponibles sur un appareil spécifié. Pour chaque police portant le nom de police spécifié, la fonction EnumFonts récupère des informations sur cette police et les transmet à la fonction de rappel définie par l’application. Cette fonction de rappel peut traiter les informations de police comme vous le souhaitez. L’énumération continue jusqu’à ce qu’il n’y ait plus de polices ou que la fonction de rappel retourne zéro.

Note Cette fonction est fournie uniquement pour la compatibilité avec les versions 16 bits de Windows. Les applications doivent utiliser la fonction EnumFontFamiliesEx .

Syntaxe

int EnumFontsA(
  [in] HDC           hdc,
  [in] LPCSTR        lpLogfont,
  [in] FONTENUMPROCA lpProc,
  [in] LPARAM        lParam
);

Paramètres

[in] hdc

Handle du contexte d’appareil à partir duquel énumérer les polices.

[in] lpLogfont

Pointeur vers une chaîne terminée par null qui spécifie le nom de police des polices souhaitées. Si lpFaceName a la valeur NULL, EnumFonts sélectionne et énumère de manière aléatoire une police de chaque police disponible.

[in] lpProc

Pointeur vers la fonction definedcallback de l’application. Pour plus d’informations, consultez EnumFontsProc.

[in] lParam

Pointeur vers toutes les données définies par l’application. Les données sont transmises à la fonction de rappel avec les informations de police.

Valeur retournée

La valeur de retour est la dernière valeur retournée par la fonction de rappel. Sa signification est définie par l’application.

Remarques

Utilisez EnumFontFamiliesEx au lieu de EnumFonts. La fonction EnumFontFamiliesEx diffère de la fonction EnumFonts en ce qu’elle récupère les noms de style associés à une police TrueType. Avec EnumFontFamiliesEx, vous pouvez récupérer des informations sur les styles de police qui ne peuvent pas être énumérés à l’aide de la fonction EnumFonts .

Les polices de nombreuses langues d’Asie de l’Est ont deux noms de police : un nom anglais et un nom localisé. EnumFonts, EnumFontFamilies et EnumFontFamiliesEx renvoient le nom de police anglais si les paramètres régionaux système ne correspondent pas à la langue de la police.

Notes

L’en-tête wingdi.h définit EnumFonts en tant qu’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