IDWriteFontSet4：：GetMatchingFonts 方法 (dwrite_3.h)

根据请求的输入生成匹配的字体集，并按顺序排序，以便更接近的匹配项更早。

语法

HRESULT GetMatchingFonts(
  WCHAR const                  *familyName,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_SIMULATIONS      allowedSimulations,
  IDWriteFontSet4              **matchingFonts
);

参数

familyName

类型：_In_z_ WCHAR const*

字体家族名称。 这可以是：版式家族名称、粗细/拉伸/样式系列名称、GDI (RBIZ) 姓氏或全名。

fontAxisValues

类型：_In_reads_ (fontAxisValueCount) DWRITE_FONT_AXIS_VALUE const*

字体轴值的数组。

fontAxisValueCount

类型： UINT32

字体轴值的数目。

allowedSimulations

类型： DWRITE_FONT_SIMULATIONS

指定哪些模拟 (，即算法放大和/或倾斜) 可以应用于匹配字体，以更好地匹配指定的轴值。 如果参数 DWRITE_FONT_SIMULATIONS_NONE (0) ，则不应用模拟。

matchingFonts

类型：_COM_Outptr_ IDWriteFontSet4**

接收指向新创建的字体集的指针，该字体集包含与指定输入匹配的优先字体列表。

返回值

类型： HRESULT

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

注解

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

要求

要求	值
最低受支持的客户端	Windows 11内部版本 22621
标头	dwrite_3.h
Library	Dwrite.lib
DLL	Dwrite.dll