描述
EnumFonts功能枚举指定设备上可用的字体。对于具有指定字体名称的每个字体,EnumFonts函数检索有关该字体的信息,并将其传递给应用程序定义的回调函数。该回调函数可以根据需要处理字体信息。枚举继续,直到没有更多的字体或回调函数返回零。
注意此函数仅用于与16位版本的Windows兼容。应用程序应使用EnumFontFamiliesEx功能。
C++ 语法
int EnumFonts( __in HDC hdc, __in LPCTSTR lpFaceName, __in FONTENUMPROC lpFontFunc, __in LPARAM lParam ); |
PowerBASIC 语法
FUNCTION EnumFontsA ( _ BYVAL hdc AS DWORD, _ BYREF lpFaceName AS ASCIIZ, _ BYVAL lpFontFunc AS DWORD, _ BYVAL lParam AS LONG _ ) AS LONG |
Unicode版本:
FUNCTION EnumFontsW ( _ BYVAL hdc AS DWORD, _ BYREF lpFaceName AS WSTRINGZ, _ BYVAL lpFontFunc AS DWORD, _ BYVAL lParam AS LONG _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
lpFaceName
[in]指向指定所需字体的字体名称的以空值终止的字符串的指针。如果lpFaceName为NULL,则EnumFonts随机选择并枚举每种可用字体的一种字体。
lpFontFunc
[in]指向应用程序的指针定义的回调函数。有关详细信息,请参阅EnumFontsProc.
lParam
[in]指向应用程序提供的数据。将数据与字体信息一起传递给回调函数。
返回值
返回值是回调函数返回的最后一个值。其含义由应用程序定义。
备注
使用EnumFontFamiliesEx而不是EnumFonts.EnumFontFamiliesEx功能与EnumFonts功能不同之处在于它检索与TrueType字体相关联的样式名称。使用EnumFontFamiliesEx,您可以使用EnumFonts功能检索无法枚举的字体样式的信息。
许多东亚语言的字体有两个字体名称:英文名称和本地化名称。EnumFonts,EnumFontFamilies和EnumFontFamiliesEx如果系统区域设置与字体的语言不匹配,则返回英文字体名称。
Windows 95/98 / Me:Microsoft Layer for Unicode支持EnumFontsW.
引用文件 #INCLUDE Once
WinGdi.inc(包括Windows.inc)