IDWriteFontFamily 介面 (dwrite.h)

代表一系列的相關字型。

繼承

IDWriteFontFamily介面繼承自IDWriteFontList。 IDWriteFontFamily 也有下列類型的成員：

方法

IDWriteFontFamily介面具有這些方法。

IDWriteFontFamily：：GetFamilyNames 建立當地語系化字串物件，其中包含以地區設定名稱編制索引的字型系列系列名稱。 (IDWriteFontFamily.GetFamilyNames)
IDWriteFontFamily：：GetFirstMatchingFont 取得最符合指定屬性的字型。
IDWriteFontFamily：：GetMatchingFonts 取得字型系列中的字型清單，依其符合指定屬性的順序排序。

備註

字型系列是一組共用相同系列名稱的字型，例如「Times New Roman」，但功能不同。 這些功能差異包括樣式，例如斜體和粗細，例如粗體。

下圖顯示「時間新羅馬」字型系列成員的字型範例。

您可以使用下列範例所示的IDWriteFontCollection：：GetFontFamily方法，從字型集合擷取IDWriteFontFamily物件。 GetFontFamily 會採用 UINT32 索引，並傳回該索引處字型的字型系列。

IDWriteFontFamily* pFontFamily = NULL;

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

字型系列名稱是用來指定文字版面配置和文字格式物件的字型系列。 您可以使用IDWriteFontFamily：：GetFamily 方法，從IDWriteFontFamily物件取得IDWriteLocalizedStrings物件形式的當地語系化字型系列名稱清單，如下列程式碼所示。

IDWriteLocalizedStrings* pFamilyNames = NULL;

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

需求

最低支援的用戶端	適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	dwrite.h

另請參閱

IDWriteFontList