Share via

IDWriteFontSetBuilder2：：AddFont 方法 (dwrite_3.h)

  • 项目

将字体添加到要生成的集，调用方提供足够的信息来搜索并确定轴范围，从而避免打开潜在的非本地字体。

语法

HRESULT AddFont(
  IDWriteFontFile              *fontFile,
  UINT32                       fontFaceIndex,
  DWRITE_FONT_SIMULATIONS      fontSimulations,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
  UINT32                       fontAxisRangeCount,
  DWRITE_FONT_PROPERTY const   *properties,
  UINT32                       propertyCount
);

参数

fontFile

类型： IDWriteFontFile*

要添加到集的字体文件引用对象。

fontFaceIndex

类型： UINT32

集合中字体面的从零开始的索引。

fontSimulations

类型： DWRITE_FONT_SIMULATIONS

用于算法放大和斜体化的字体人脸模拟标志。

fontAxisValues

类型： DWRITE_FONT_AXIS_VALUE const *

指向包含字体轴值列表的数组的指针。 数组的大小 (由 fontAxisValueCount 参数指示的元素数) 。

fontAxisValueCount

类型： UINT32

fontAxisValues 数组中包含的字体轴值的数目。

fontAxisRanges

类型： DWRITE_FONT_AXIS_RANGE const *

轴范围列表。

fontAxisRangeCount

类型： UINT32

轴范围的数目。

properties

类型： DWRITE_FONT_PROPERTY const *

要与引用关联的属性列表。

propertyCount

类型： UINT32

定义的属性数。

返回值

类型： HRESULT

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

备注

字体属性应至少包括一个系列 (版式或粗细/样式/拉伸) 。 否则，只能在 IDWriteFontSet 中通过索引（而不是名称）访问字体。

要求

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