enumFontFamiliesW 函数 (wingdi.h)

项目
08/27/2023

EnumFontFamilies 函数枚举指定字体系列中在指定设备上可用的字体。

注意提供此函数只是为了与 16 位版本的 Windows 兼容。应用程序应使用 EnumFontFamiliesEx 函数。

语法

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

参数

[in] hdc

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

[in] lpLogfont

指向以 null 结尾的字符串的指针，该字符串指定所需字体的系列名称。如果 lpszFamily 为 NULL， 则 EnumFontFamilies 选择并枚举每个可用类型系列的一个字体。

[in] lpProc

指向应用程序定义的回调函数的指针。有关信息，请参阅 EnumFontFamProc。

[in] lParam

指向应用程序提供的数据的指针。数据与字体信息一起传递给回调函数。

返回值

返回值是回调函数返回的最后一个值。其含义特定于实现。

注解

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

当使用 SetGraphicsMode 函数将设备上下文中的图形模式设置为 GM_ADVANCED 并将 DEVICE_FONTTYPE 标志传递给 FontType 参数时，此函数将在系统上返回类型 1 和 OpenType 字体的列表。当图形模式未设置为 GM_ADVANCED 时，此函数将在系统上返回类型 1、OpenType 和 TrueType 字体的列表。

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

示例

有关示例，请参阅枚举已安装字体。

注意

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

要求

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