Fonction EnumFontsA (wingdi.h)

Article
11/20/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 la 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.

Remarque 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 vers le contexte de l’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 est NULL, EnumFonts sélectionne de manière aléatoire et énumère 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 ainsi que les informations de police.

Valeur de retour

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 dans laquelle 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 pour de nombreuses langues d’Asie de l’Est ont deux noms de police : un nom anglais et un nom localisé. EnumFonts, EnumFontFamilieset EnumFontFamiliesEx renvoyer le nom de la police anglaise si les paramètres régionaux système ne correspondent pas à la langue de la police.

Note

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