EnumFontFamiliesA 関数 (wingdi.h)

[アーティクル]
08/27/2023

EnumFontFamilies 関数は、指定したデバイスで使用できる、指定したフォントファミリ内のフォントを列挙します。

メモこの関数は、16 ビットバージョンの Windows との互換性のためにのみ提供されます。アプリケーションでは EnumFontFamiliesEx 関数を使用する必要があります。

構文

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