EnumFontFamiliesExA 関数 (wingdi.h)

EnumFontFamiliesEx 関数は、LOGFONT 構造体で指定されたフォント特性と一致するシステム内のすべての一意の名前付きフォントを列挙します。 EnumFontFamiliesEx は、書体名、文字セット、またはその両方に基づいてフォントを列挙します。

構文

int EnumFontFamiliesExA(
  [in] HDC           hdc,
  [in] LPLOGFONTA    lpLogfont,
  [in] FONTENUMPROCA lpProc,
  [in] LPARAM        lParam,
       DWORD         dwFlags
);

パラメーター

[in] hdc

フォントを列挙するデバイス コンテキストへのハンドル。

[in] lpLogfont

列挙するフォントに関する情報を含む LOGFONT 構造体へのポインター。 関数は、次のメンバーを調べます。

[in] lpProc

アプリケーション定義のコールバック関数へのポインター。 詳細については、 EnumFontFamExProc 関数に関するページを参照してください。

[in] lParam

アプリケーション定義値。 関数は、この値をフォント情報と共にコールバック関数に渡します。

dwFlags

このパラメーターは使われていないので、0 にする必要があります。

戻り値

戻り値は、コールバック関数によって返される最後の値です。 この値は、指定したデバイスで使用できるフォント ファミリによって異なります。

注釈

EnumFontFamiliesEx 関数は、文字セットを識別するためにタグ付けされた書体名を使用しません。 代わりに、常に正しい書体名と別の文字セット値をコールバック関数に渡します。 関数は、LOGFONT 構造体の lfCharSet メンバーと lfFaceName メンバーの値に基づいてフォントを列挙します。

EnumFontFamilies と同様に、EnumFontFamiliesEx はすべてのフォント スタイルを列挙します。 フォントのすべてのスタイルが同じ文字セットをカバーしているわけではありません。 たとえば、Fontorama Bold には ANSI、ギリシャ語、キリル文字が含まれる場合がありますが、Fontorama Italic には ANSI 文字のみが含まれる場合があります。 このため、ANSI 文字セットであっても、指定したフォントが特定の文字セットをカバーしているとは限りません。 次の表は、 lfCharSet と lfFaceName のさまざまな値の組み合わせの結果を示しています。

次のコード サンプルは、これらの値の使用方法を示しています。

// To enumerate all styles and charsets of all fonts: 
lf.lfFaceName[0] = '\0';
lf.lfCharSet = DEFAULT_CHARSET;
HRESULT hr;

// To enumerate all styles and character sets of the Arial font: 
hr = StringCchCopy( (LPSTR)lf.lfFaceName, LF_FACESIZE, "Arial" );
if (FAILED(hr))
{
// TODO: write error handler 
}

lf.lfCharSet = DEFAULT_CHARSET;

// To enumerate all styles of all fonts for the ANSI character set 
lf.lfFaceName[0] = '\0';
lf.lfCharSet = ANSI_CHARSET;

// To enumerate all styles of Arial font that cover the ANSI charset 
hr = StringCchCopy( (LPSTR)lf.lfFaceName, LF_FACESIZE, "Arial" );
if (FAILED(hr))
{
// TODO: write error handler 
}

lf.lfCharSet = ANSI_CHARSET;

EnumFontFamilies と EnumFontFamiliesEx のコールバック関数は非常によく似ています。 メイン違いは、ENUMLOGFONTEX 構造体にスクリプト フィールドが含まれていることです。

lfCharSet と lfFaceName の値に基づいて、EnumFontFamiliesEx は、フォントに個別の文字セットがあるのと同じフォントを何度も列挙することに注意してください。 これにより、ユーザーに負担がかかる可能性があるフォントの広範な一覧が作成される可能性があります。 たとえば、バルト、西部、ギリシャ語、トルコ語、キリル文字セットに対して Century Schoolbook フォントを表示できます。 これを回避するには、アプリケーションでフォントの一覧をフィルター処理する必要があります。

多くの東アジア言語のフォントには、英語名とローカライズされた名前の 2 つの書体名があります。 システム ロケールがフォントの言語と一致しない場合、EnumFonts、EnumFontFamilies、EnumFontFamiliesEx は英語の書体名を返します。

デバイス コンテキストのグラフィックス モードが SetGraphicsMode 関数を使用してGM_ADVANCEDに設定され、DEVICE_FONTTYPE フラグが FontType パラメーターに渡されると、この関数はシステム上の型 1 および OpenType フォントの一覧を返します。 グラフィックス モードが GM_ADVANCED に設定されていない場合、この関数は、システム上の種類 1、OpenType、および TrueType フォントの一覧を返します。

要件

こちらもご覧ください

EnumFontFamExProc

EnumFontFamilies

EnumFonts

フォント関数とテキスト関数

フォントとテキストの概要

Logfont