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 内部版本 16299
支持的最低服务器	Windows 10 内部版本 16299
目标平台	窗户
标头	dwrite_3.h
库	Dwrite.lib