函式功能
該函式列舉系統里所有符合由LOGFONT結構指定的字型特性的字型。此函式基於字樣名或字元集或兩者來枚舉字型。
函式原型
int EnumFontFamiliesEx(HDC hdc, LPLOGFONT lpLogfont, FONTENUMPROC lpEnumFontFamExProc, LPARAM lParam, DWORD dwFlags);
主要參數
hdc:設備環境句柄。
lpLogfont:指向結構LOGFONT的指針,結構里含有要列舉字型的信息。此函式檢查下列成員:
lfCharset如果設定為DEFAULT_CHARSET,此函式列舉所有字元集裡的所有字型。如果設定了一個合法字元集值,此函式列舉指定字元集裡的字型。
lfFaceName如果設定為空串,此函式列舉每一個可用字樣名的一種字型。如果設定了一個指定的字樣名,此函式列舉指定名字的所有字型。
LfPitchAndFamily除Hebrew和Arabic以外,對作業系統的所有語言形式都設定為0。對語言而言,給lfPitchAndFamily設定MONO_FONT值只列舉那些能在該字型里提供所有代碼頁字元的字型。
lpEnumFontFamexProc:指向應用程式定義的回調函式的指針,要得到更多的善於回調函式的信息,參見函式EnumFontFamExProc。
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兩種方式實現。