IDWriteFontFamily インターフェイス (dwrite.h)

関連するフォントのファミリを表します。

継承

IDWriteFontFamily インターフェイスは、IDWriteFontList から継承します。 IDWriteFontFamily には、次の種類のメンバーもあります。

メソッド

IDWriteFontFamily インターフェイスには、これらのメソッドがあります。

IDWriteFontFamily::GetFamilyNames ロケール名でインデックス付けされたフォント ファミリのファミリ名を含むローカライズされた文字列オブジェクトを作成します。 (IDWriteFontFamily.GetFamilyNames)
IDWriteFontFamily::GetFirstMatchingFont 指定したプロパティに最も一致するフォントを取得します。
IDWriteFontFamily::GetMatchingFonts 指定したプロパティと一致する順序でランク付けされたフォント ファミリ内のフォントの一覧を取得します。

解説

フォント ファミリは、"Times New Roman" のように同じファミリ名を共有する一連のフォントですが、機能は異なります。 これらの機能の違いには、斜体などのスタイル、太さ (太字など) が含まれます。

次の図は、"Times New Roman" フォント ファミリのメンバーであるフォントの例を示しています。

IDWriteFontFamily オブジェクトは、次の例に示す IDWriteFontCollection::GetFontFamily メソッドを使用してフォント コレクションから取得できます。 GetFontFamily はUINT32 インデックスを取得し、そのインデックスにあるフォントのフォント ファミリを返します。

IDWriteFontFamily* pFontFamily = NULL;

// Get the font family.
if (SUCCEEDED(hr))
{
    hr = pFontCollection->GetFontFamily(i, &pFontFamily);
}

フォント ファミリ名は、テキスト レイアウトおよびテキスト書式オブジェクトのフォント ファミリを指定するために使用されます。 次のコードに示すように、IDWriteFontFamily::GetFamilyNames メソッドを使用して、IDWriteFontFamily オブジェクトから IDWriteLocalizedStrings オブジェクトの形式でローカライズされたフォント ファミリ名の一覧を取得できます。

IDWriteLocalizedStrings* pFamilyNames = NULL;

// Get a list of localized strings for the family name.
if (SUCCEEDED(hr))
{
    hr = pFontFamily->GetFamilyNames(&pFamilyNames);
}

要件

サポートされている最小のクライアント	Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	dwrite.h

関連項目

IDWriteFontList