Share via

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

  • 项目

检索按给定范围（包括终结点）筛选的字体子集。

语法

HRESULT GetFilteredFonts(
        DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
        UINT32                       fontAxisRangeCount,
        BOOL                         selectAnyRange,
  [out] IDWriteFontSet1              **filteredFontSet
);

参数

fontAxisRanges

类型： DWRITE_FONT_AXIS_RANGE const *

要筛选的轴值范围的列表。

fontAxisRangeCount

类型： UINT32

要筛选的轴值范围的数目。

selectAnyRange

类型： BOOL

true 如果 GetFilteredFonts 应选择任何范围，则为 ; 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