通过

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
库 Dwrite.lib
DLL Dwrite.dll