通过

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 内部版本 16299
支持的最低服务器 Windows 10 内部版本 16299
目标平台 窗户
标头 dwrite_3.h
库 Dwrite.lib