IDWriteFontResource：：CreateFontFaceReference 方法 （dwrite_3.h）

创建具有特定轴值的字体人脸引用。

语法

HRESULT CreateFontFaceReference(
        DWRITE_FONT_SIMULATIONS      fontSimulations,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontFaceReference1    **fontFaceReference
);

参数

fontSimulations

类型：DWRITE_FONT_SIMULATIONS

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

fontAxisValues

类型：DWRITE_FONT_AXIS_VALUE const *

指向包含字体轴值列表的数组的指针。 数组应为 fontAxisValueCount 参数指示的大小（元素数）。

fontAxisValueCount

类型：UINT32

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

[out] fontFaceReference

类型：IDWriteFontFaceReference1**

指向 IDWriteFontFaceReference1 接口的指针的地址。 成功完成后，该函数将指针设置为新创建的字体人脸引用对象，否则它将指针设置为 nullptr。

返回值

类型：HRESULT

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

言论

允许你提供的轴值是字体实际支持的所有轴值的子集或超集。 任何未指定的轴都使用默认值：超出范围的值将被固定，并且任何不可变的轴都不起作用。

要求