enumFontsA 函数 (wingdi.h)

项目
08/27/2023

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

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

语法

int EnumFontsA(
  [in] HDC           hdc,
  [in] LPCSTR        lpLogfont,
  [in] FONTENUMPROCA lpProc,
  [in] LPARAM        lParam
);

参数

[in] hdc

从中枚举字体的设备上下文的句柄。

[in] lpLogfont

指向以 null 结尾的字符串的指针，该字符串指定所需字体的字体名称。如果 lpFaceName 为 NULL， 则 EnumFonts 会随机选择并枚举每个可用字体的一个字体。

[in] lpProc

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

[in] lParam

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

返回值

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

注解

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

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

注意

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

要求

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