EnumFontFamiliesA 関数 (wingdi.h)
EnumFontFamilies 関数は、指定したデバイスで使用できる、指定したフォント ファミリ内のフォントを列挙します。
構文
int EnumFontFamiliesA(
[in] HDC hdc,
[in] LPCSTR lpLogfont,
[in] FONTENUMPROCA lpProc,
[in] LPARAM lParam
);
パラメーター
[in] hdc
フォントを列挙するデバイス コンテキストへのハンドル。
[in] lpLogfont
目的のフォントのファミリ名を指定する null で終わる文字列へのポインター。 lpszFamily が NULL の場合、EnumFontFamilies は使用可能な型ファミリごとに 1 つのフォントを選択して列挙します。
[in] lpProc
アプリケーション定義のコールバック関数へのポインター。 詳細については、「 EnumFontFamProc」を参照してください。
[in] lParam
アプリケーションが提供するデータへのポインター。 データは、フォント情報と共にコールバック関数に渡されます。
戻り値
戻り値は、コールバック関数によって返される最後の値です。 その意味は実装固有です。
注釈
lpszFamily パラメーターで指定された書体名を持つフォントごとに、EnumFontFamilies 関数はそのフォントに関する情報を取得し、lpEnumFontFamProc パラメーターが指す関数に渡します。 アプリケーション定義のコールバック関数は、必要に応じてフォント情報を処理できます。 列挙体は、フォントがなくなったか、コールバック関数から 0 が返されるまで続行されます。
デバイス コンテキストのグラフィックス モードが SetGraphicsMode 関数を使用してGM_ADVANCEDに設定され、DEVICE_FONTTYPE フラグが FontType パラメーターに渡されると、この関数はシステム上の型 1 および OpenType フォントの一覧を返します。 グラフィックス モードが GM_ADVANCED に設定されていない場合、この関数はシステム上の種類 1、OpenType、および TrueType フォントの一覧を返します。
多くの東アジア言語のフォントには、英語名とローカライズされた名前の 2 つの書体名があります。 システム ロケールがフォントの言語と一致しない場合、EnumFonts、EnumFontFamilies、EnumFontFamiliesEx は英語の書体名を返します。
例
例については、「 インストールされているフォントの列挙」を参照してください。
注意
wingdi.h ヘッダーは EnumFontFamilies をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |