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错误代码

备注

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

要求

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