描述
EnumFontFamilies函数枚举指定字体系列中指定设备上可用的字体。
注意此函数仅适用于与16位版本的Windows兼容。应用程序应使用EnumFontFamiliesEx功能。
C++ 语法
int EnumFontFamilies( __in HDC hdc, __in LPCTSTR lpszFamily, __in FONTENUMPROC lpEnumFontFamProc, __in LPARAM lParam ); |
PowerBASIC 语法
FUNCTION EnumFontFamiliesA ( _ BYVAL hdc AS DWORD, _ BYREF lpszFamily AS ASCIIZ, _ BYVAL lpEnumFontFamProc AS DWORD, _ BYVAL lParam AS LONG _ ) AS LONG |
Unicode版本:
FUNCTION EnumFontFamiliesW ( _ BYVAL hdc AS DWORD, _ BYREF lpszFamily AS WSTRINGZ, _ BYVAL lpEnumFontFamProc AS DWORD, _ BYVAL lParam AS LONG _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
lpszFamily
[in]指向指定所需字体的家族名称的以null结尾的字符串的指针。如果lpszFamily为NULL,则EnumFontFamilies选择并枚举每个可用类型族的一种字体。
lpEnumFontFamProc
[in]指向应用程序定义的回调函数的指针。有关信息,请参阅EnumFontFamProc.
lParam
[in]指向应用程序提供的数据。将数据与字体信息一起传递给回调函数。
返回值
返回值是回调函数返回的最后一个值。其含义是具体实现。
备注
对于具有由lpszFamily参数指定的字体名称的每个字体,EnumFontFamilies函数将检索有关该字体的信息,并将其传递给lpEnumFontFamProc参数指向的函数。应用程序定义的回调函数可以根据需要处理字体信息。枚举继续,直到没有更多的字体或回调函数返回零。
当使用SetGraphicsMode函数将设备上下文的图形模式设置为GM_ADVANCED,并将DEVICE_FONTTYPE标志传递给FontType参数时,此函数将返回系统上的类型1和OpenType字体的列表。当图形模式未设置为GM_ADVANCED时,该函数将返回系统上的类型1,OpenType和TrueType字体的列表。
许多东亚语言的字体有两个字体名称:英文名称和本地化名称。EnumFonts,EnumFontFamilies和EnumFontFamiliesEx如果系统区域设置与字体的语言不匹配,则返回英文字体名称。
Windows 95/98 / Me:Microsoft Layer for Unicode支持EnumFontFamiliesW.
引用文件 #INCLUDE Once
WinGdi.inc(包括Windows.inc)