IDWriteFontCollection2::GetMatchingFonts 方法 (dwrite_3.h)
检索指定字体系列中的字体列表,这些字体按与指定轴值匹配程度的顺序进行排名。
语法
HRESULT GetMatchingFonts(
WCHAR const *familyName,
DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
UINT32 fontAxisValueCount,
[out] IDWriteFontList2 **fontList
);
参数
familyName
类型: WCHAR const *
字体系列的名称。 该名称不区分大小写,但必须完全匹配集合中的家族名称。
fontAxisValues
类型: DWRITE_FONT_AXIS_VALUE const *
指向包含字体轴值列表的数组的指针。 数组的大小应 (fontAxisValueCount 参数指示的元素数) 。
fontAxisValueCount
类型: UINT32
fontAxisValues 数组中包含的字体轴值的数目。
[out] fontList
类型: IDWriteFontList2**
指向 IDWriteFontList2 接口的指针的地址。 成功完成后,函数会将指针设置为新创建的字体列表对象。
返回值
类型: HRESULT
如果函数成功,则返回 S_OK。 否则,它将返回 HRESULT错误代码。
注解
如果没有字体匹配,则 (调用 IDWriteFontList::GetFontCount 的空列表对象返回 0) ,但函数不会返回错误。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10内部版本 20348 |
最低受支持的服务器 | Windows 10内部版本 20348 |
目标平台 | Windows |
标头 | dwrite_3.h |
Library | Dwrite.lib |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈