基本介紹
- 中文名:EnumFontFamiliesEx
- 功能:由LOGFONT結構指定的字型特性的
- 原型:int EnumFontFamiliesEx
- 參數:hdc:設備環境句柄
- 類型:函式
函式功能,函式原型,參數,返回值,備註,速查,
函式功能
該函式列舉系統里所有符合由LOGFONT結構指定的字型特性的字型。此函式基於字樣名或字元集或兩者來枚舉字型。
函式原型
int EnumFontFamiliesEx(HDC hdc, LPLOGFONT lpLogfont, FONTENUMPROC lpEnumFontFamExProc, LPARAM lParam, DWORD dwFlags);
參數
hdc:設備環境句柄。
lpLogfont:指向結構LOGFONT的指針,結構里含有要列舉字型的信息。此函式檢查下列成員:
lfFaceName如果設定為空串,此函式列舉每一個可用字樣名的一種字型。如果設定了一個指定的字樣名,此函式列舉指定名字的所有字型。
LfPitchAndFamily除Hebrew和Arabic以外,對作業系統的所有語言形式都設定為0。對語言而言,給lfPitchAndFamily設定MONO_FONT值只列舉那些能在該字型里提供所有代碼頁字元的字型。
lParam:指定一個32位應用程式定義的值,此函式傳遞此值和字型信息給回調函式。
dwFlags:保留值,必為0。
返回值
此返回值是由回調函式返回的最後一個值,此值依賴於提供給指定設備的字型族。
備註
EnumFontFamiliesEx不使用字樣名tagged來標識字元集,而改為傳遞正確的字樣名和單獨的字元集值給回調函式,此函式基於LOGFONT結構里的lfCharset和lfFacename值來列舉字型。
如果lfCharset的值為DEFAULT_CHARSET且lfFaceName是一個空串,則此函式列舉為每一個字元集的每個字列舉一種字全,如果lfFaceName非空,則此函式無論字元集如何,都列舉指定字樣里的每一種字型。
如果lfCharset是一個有效的字元集值且lfFaceName是空串,則此函式列舉指定字元集的每一種字型。如果lfFaceName非空,則此函式列舉有著指定字樣和字元集的每一種字型。
速查
Windows NT:4.0及以上版本;Windows:95及以上版本;Windows CE:不支持;頭檔案:wingdi.h;庫檔案:gdi32.lib;Unicode:在Windows NT環境下以Unicode和ANSI兩種方式實現。