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

EnumFontFamilies

Previous pageReturn to chapter overviewNext page

描述

 

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字体的列表。

 

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

 

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

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)