IDWriteFactory::CreateFontFace 方法 (dwrite.h)

创建表示字体的 对象。

语法

HRESULT CreateFontFace(
        DWRITE_FONT_FACE_TYPE   fontFaceType,
        UINT32                  numberOfFiles,
  [in]  IDWriteFontFile         * const *fontFiles,
        UINT32                  faceIndex,
        DWRITE_FONT_SIMULATIONS fontFaceSimulationFlags,
  [out] IDWriteFontFace         **fontFace
);

参数

fontFaceType

类型: DWRITE_FONT_FACE_TYPE

一个 值,该值指示字体的文件格式的类型。

numberOfFiles

类型: UINT32

表示字体面所需的字体文件数(以元素计数为单位)。

[in] fontFiles

类型: const IDWriteFontFile*

表示字体的字体文件对象。 由于 IDWriteFontFace 维护自己对输入字体文件对象的引用,因此可以在调用后释放它们。

faceIndex

类型: UINT32

字体的从零开始的索引,如果字体文件包含字体面的集合。 如果字体文件包含一张人脸,此值应为零。

fontFaceSimulationFlags

类型: DWRITE_FONT_SIMULATIONS

一个值,该值指示将哪些字体人脸模拟标志应用于当前字体,以便将文本加粗或倾斜的算法方法。

[out] fontFace

类型: IDWriteFontFace**

此方法返回时,包含指向新创建的字体人脸对象的指针的地址,如果失败,则为 NULL

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 dwrite.h
Library Dwrite.lib
DLL Dwrite.dll

请参阅

IDWriteFactory