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