Fonction EnumFontFamiliesA (wingdi.h)

Article
11/20/2024

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

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 EnumFontFamiliesA(
  [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 famille des polices souhaitées. Si lpszFamily est 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 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 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 la 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 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.

Exemples

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

Note

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