Fonction EnumFontFamiliesW (wingdi.h)
La fonction EnumFontFamilies énumère les polices d’une famille de polices spécifiée qui sont disponibles sur un appareil spécifié.
Syntaxe
int EnumFontFamiliesW(
[in] HDC hdc,
[in] LPCWSTR lpLogfont,
[in] FONTENUMPROCW 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 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 renvoient le nom de police 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 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 |