IDWriteFactory6::CreateFontFaceReference 方法 (dwrite_3.h)

创建对文件中特定字体实例的引用。

语法

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

参数

fontFile

类型:IDWriteFontFile*

用户提供的字体文件,表示字体人脸。

faceIndex

类型:UINT32

字体文件包含字体人脸集合时,字体人脸的从零开始的索引。 如果字体文件包含单个人脸,则将此值设置为零。

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
目标平台 窗户
标头 dwrite_3.h
Dwrite.lib