EnumFonts

小甲鱼

注：本文档由 CET-6-WPW 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

EnumFonts 函数用于枚举指定的设备上的可用字体。对于每个指定字样名称的字体，EnumFonts 函数检索有关该字体的信息，并将其传递给应用程序定义的回调函数。此回调函数可以按期望处理字体信息。枚举会一直继续，直到没有更多的字体或回调函数返回零。

注意：此函数只供与 16 位版本的 Windows 的兼容性。新应用程序应使用 EnumFontFamiliesEx 函数。


API 函数原型：

注释：_In_ 说明该参数是输入的。

int EnumFonts(
  _In_ HDC          hdc,
  _In_ LPCTSTR      lpFaceName,
  _In_ FONTENUMPROC lpFontFunc,
  _In_ LPARAM       lParam
);

参数解析：

参数	含义
hdc	指定设备环境句柄
lpFaceName	1. 一个指向以 null 结尾的字符串，指定所需的字体的字样名称 2. 如果 lpFaceName 参数为 NULL，EnumFonts 函数随机选择，并列举每个有效字样的一种字体
lpFontFunc	指向应用程序定义的回调函数的指针。有关更多信息，请参见 EnumFontsProc
lParam	指向应用程序定义的任何数据的指针。数据伴随字体信息一起传递给回调函数

返回值：

返回值是由回调函数返回的最后一个值。其含义是由应用程序定义的。


备注：

1. 现在你应该使用 EnumFontFamiliesEx 函数而不是 EnumFonts。EnumFontFamiliesEx 函数不同于 EnumFonts 函数，它检索与 TrueType 字体相关联的样式名称。使用 EnumFontFamiliesEx 函数可以检索用 EnumFonts 函数不能枚举到的字体样式的信息。

2. 对于许多东亚语言字体有两个字体名称︰ 英文名称和本地化的名称。如果系统区域设置与字体的语言不匹配，EnumFonts、EnumFontFamilies 和 EnumFontFamiliesEx 函数返回英文字体名称。


需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Wingdi.h (包含于 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll
Unicode and ANSI names	EnumFontsW (Unicode) 和 EnumFontsA (ANSI)

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。