idWriteFontFamily 接口 (dwrite.h)

表示一系列相关字体。

继承

IDWriteFontFamily 接口继承自 IDWriteFontList。 IDWriteFontFamily 还具有以下类型的成员：

方法

IDWriteFontFamily 接口包含以下方法。

IDWriteFontFamily：：GetFamilyNames 创建一个本地化字符串对象，该对象包含字体系列的系列名称，按区域设置名称编制索引。 (IDWriteFontFamily.GetFamilyNames)
IDWriteFontFamily：：GetFirstMatchingFont 获取与指定属性最匹配的字体。
IDWriteFontFamily：：GetMatchingFonts 获取字体系列中字体的列表，这些字体按与指定属性的匹配程度排序。

备注

字体系列是一组共享同一系列名称的字体，例如“Times New Roman”，但在功能上有所不同。 这些功能差异包括样式（如斜体）和粗细（如粗体）。

下图显示了属于“Times New Roman”字体系列成员的字体示例。

可以使用以下示例所示的 IDWriteFontCollection：：GetFontFamily 方法从字体集合中检索 IDWriteFontFamily 对象。 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、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	dwrite.h

请参阅

IDWriteFontList