Fonction EnumFontFamiliesA (wingdi.h)

Article
08/27/2023

La fonction EnumFontFamilies énumère les polices d’une famille de polices spécifiée qui sont disponibles sur un appareil spécifié.

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 EnumFontFamiliesA(
  [in] HDC           hdc,
  [in] LPCSTR        lpLogfont,
  [in] FONTENUMPROCA lpProc,
  [in] LPARAM        lParam
);

Paramètres

[in] hdc

Handle du 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 famille des polices souhaitées. Si lpszFamily a la valeur NULL, EnumFontFamilies sélectionne et énumère une police de chaque famille de types disponibles.

[in] lpProc

Pointeur vers la fonction de rappel définie par l’application. Pour plus d’informations, consultez EnumFontFamProc.

[in] lParam

Pointeur vers les données fournies 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 spécifique à l’implémentation.

Remarques

Pour chaque police ayant le nom de police spécifié par le paramètre lpszFamily , la fonction EnumFontFamilies récupère des informations sur cette police et les transmet à la fonction pointée par le paramètre lpEnumFontFamProc . La fonction de rappel définie par l’application 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.

Lorsque le mode graphique sur le contexte de l’appareil est défini sur GM_ADVANCED à l’aide de la fonction SetGraphicsMode et que l’indicateur DEVICE_FONTTYPE est passé au paramètre FontType, cette fonction retourne une liste de polices de type 1 et OpenType sur le système. Lorsque le mode graphique n’est pas défini sur GM_ADVANCED, cette fonction retourne une liste de polices de type 1, OpenType et TrueType sur le système.

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 retournent le nom de police en anglais si les paramètres régionaux système ne correspondent pas à la langue de la police.

Exemples

Pour obtenir des exemples, consultez Énumération des polices installées.

Notes

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

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