通过

IDWriteFontSet：：GetMatchingFonts (WCHARconst*，DWRITE_FONT_WEIGHT，DWRITE_FONT_STRETCH，DWRITE_FONT_STYLE，IDWriteFontSet**) 方法 (dwrite_3.h)

  • 项目

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

语法

HRESULT GetMatchingFonts(
  WCHAR const         *familyName,
  DWRITE_FONT_WEIGHT  fontWeight,
  DWRITE_FONT_STRETCH fontStretch,
  DWRITE_FONT_STYLE   fontStyle,
  IDWriteFontSet      **filteredSet
);

参数

familyName

字体系列名称。

fontWeight

字体粗细。

fontStretch

字体拉伸值。

fontStyle

字体样式。

filteredSet

类型：[out] IDWriteFontSet**

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

返回值

类型： HRESULT

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

注解

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

要求

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

另请参阅

IDWriteFontSet