Share via

IDWriteFontSet1：：GetFilteredFonts (DWRITE_FONT_PROPERTYconst*，UINT32，BOOL，IDWriteFontSet1**) 方法 (dwrite_3.h)

  • 项目

检索按给定属性筛选的字体子集。

语法

HRESULT GetFilteredFonts(
        DWRITE_FONT_PROPERTY const *properties,
        UINT32                     propertyCount,
        BOOL                       selectAnyProperty,
  [out] IDWriteFontSet1            **filteredFontSet
);

参数

properties

类型： DWRITE_FONT_PROPERTY const *

要筛选的属性列表。

propertyCount

类型： UINT32

要筛选的属性数。

selectAnyProperty

类型： BOOL

true 如果 GetFilteredFontIndices 应选择任何属性，则为 ; false 如果它应选择它们全部的交集，则为 。

[out] filteredFontSet

类型： IDWriteFontSet1**

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

返回值

类型： HRESULT

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

注解

如果没有字体与筛选器匹配，则返回的子集对象将为空， (调用 IDWriteFontSet：：GetFontCount 时返回 0) ，但函数不会返回错误。 子集始终等于或小于原始集。

要求

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