IDWriteFontSet::GetMatchingFonts (DWRITE_FONT_PROPERTYconst*,UINT32,IDWriteFontSet**) 方法 (dwrite_3.h)

返回按给定属性筛选的字体子集。

语法

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const *properties,
  UINT32                     propertyCount,
  IDWriteFontSet             **filteredSet
);

参数

properties

类型:[in] const DWRITE_FONT_PROPERTY*

用于筛选的属性列表。

propertyCount

类型: UINT32

要筛选的属性数。

filteredSet

类型:[out] IDWriteFontSet**

与属性匹配的字体子集,失败时为 nullptr。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

备注

如果没有与筛选器匹配的字体, (GetFontCount 返回 0) ,则子集将为空,但函数不会返回错误。 子集将始终等于或小于原始集。 如果只想筛选掉远程字体,可以在 properties 中传递 null,在 propertyCount 中传递零。

要求

   
最低受支持的客户端 Windows 10 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 dwrite_3.h
Library Dwrite.lib
DLL Dwrite.dll

请参阅

IDWriteFontSet