EnumFontsW 函数（wingdi.h）

项目
11/20/2024

EnumFonts 函数枚举指定设备上可用的字体。对于具有指定字号的每个字体，EnumFonts 函数检索有关该字体的信息，并将其传递给应用程序定义的回调函数。此回调函数可以根据需要处理字体信息。枚举将继续，直到没有更多字体或回调函数返回零。

注意此函数仅用于与 16 位版本的 Windows 兼容。应用程序应使用 EnumFontFamiliesEx 函数。

语法

int EnumFontsW(
  [in] HDC           hdc,
  [in] LPCWSTR       lpLogfont,
  [in] FONTENUMPROCW lpProc,
  [in] LPARAM        lParam
);

参数

[in] hdc

用于枚举字体的设备上下文的句柄。

[in] lpLogfont

指向以 null 结尾的字符串的指针，该字符串指定所需字体的字样名称。如果 lpFaceNameNULL，EnumFonts 随机选择并枚举每个可用字面的一种字体。

[in] lpProc

指向应用程序 definedcallback 函数的指针。有关详细信息，请参阅 EnumFontsProc。

[in] lParam

指向任何应用程序定义数据的指针。数据将连同字体信息一起传递到回调函数。

返回值

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

言论

使用 EnumFontFamiliesEx，而不是 EnumFonts。 EnumFontFamiliesEx 函数不同于 EnumFonts 函数，因为它检索与 TrueType 字体关联的样式名称。使用 EnumFontFamiliesEx，可以检索无法使用 EnumFonts 函数枚举的字体样式的信息。

许多东亚语言的字体有两个字号：英语名称和本地化名称。 EnumFonts、EnumFontFamilies，EnumFontFamiliesEx 如果系统区域设置与字体语言不匹配，则返回英语字样名称。

注意

wingdi.h 标头将 EnumFonts 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	wingdi.h （包括 Windows.h）
库	Gdi32.lib
DLL	Gdi32.dll