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 |