Share via

IDWriteFontSet1：：GetMatchingFonts 方法 (dwrite_3.h)

  • 项目

检索基于请求的输入的匹配字体集，排序以便更接近的匹配项更早。

语法

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const   *fontProperty,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  IDWriteFontSet1              **matchingFonts
);

参数

fontProperty

类型： DWRITE_FONT_PROPERTY const *

感兴趣的字体属性，如版式系列或粗细/拉伸/样式系列。

fontAxisValues

类型： DWRITE_FONT_AXIS_VALUE const *

指向包含字体轴值列表的数组的指针。 数组的大小 (由 fontAxisValueCount 参数指示的元素数) 。

fontAxisValueCount

类型： UINT32

fontAxisValues 数组中包含的字体轴值的数目。

matchingFonts

类型： IDWriteFontSet1**

指向 IDWriteFontSet1 接口的指针的地址。 成功完成后， 函数将指针设置为与 属性匹配的字体的优先列表，否则将指针设置为 nullptr。

返回值

类型： HRESULT

如果函数成功，则返回 S_OK。 否则，它将返回 HRESULT错误代码。

备注

此方法可以生成不在原始字体集中的不同项，包括具有模拟标志的项目 (（如果它们与请求) 更匹配）以及字体作者未命名的实例。 来自同一字体资源的项将折叠为一个：最接近的可能匹配项。

要求

   
最低受支持的客户端 Windows 10内部版本 20348
最低受支持的服务器 Windows 10内部版本 20348
目标平台 Windows
标头 dwrite_3.h
Library Dwrite.lib