IDWriteFontSet1::GetFilteredFonts (UINT32const*,UINT32,IDWriteFontSet1**) 方法 (dwrite_3.h)

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

语法

HRESULT GetFilteredFonts(
        UINT32 const    *indices,
        UINT32          indexCount,
  [out] IDWriteFontSet1 **filteredFontSet
);

参数

indices

类型: UINT32 const *

要筛选的索引数组,范围为 0 到 IDwriteFontSet::GetFontCount 减 1。

indexCount

类型: UINT32

索引的数目。

[out] filteredFontSet

类型: IDWriteFontSet1**

指向 IDWriteFontSet1 接口的指针的地址。 成功完成后, 函数将指针设置为表示给定索引所指示字体子集的 对象,否则将指针设置为 nullptr

返回值

类型: HRESULT

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

注解

索引可以按任意顺序排列,这意味着 GetFilteredFonts 可以生成一个新集,其中项从原始项中删除、重复或重新排序。 如果传递零个索引,则返回空字体集。

要求

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