勇芳软件工作室.汉化:  Fonts and Text > Fonts and Text Functions >

EnumFonts

Previous pageReturn to chapter overviewNext page

描述

 

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功能检索无法枚举的字体样式的信息。

 

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

 

Windows 95/98 / Me:Microsoft Layer for Unicode支持EnumFontsW.

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)