IDWriteFactory::CreateTextFormat 方法 (dwrite.h)

创建用于文本布局的文本格式对象。

语法

HRESULT CreateTextFormat(
  [in]  WCHAR const           *fontFamilyName,
        IDWriteFontCollection *fontCollection,
        DWRITE_FONT_WEIGHT    fontWeight,
        DWRITE_FONT_STYLE     fontStyle,
        DWRITE_FONT_STRETCH   fontStretch,
        FLOAT                 fontSize,
  [in]  WCHAR const           *localeName,
  [out] IDWriteTextFormat     **textFormat
);

参数

[in] fontFamilyName

类型: const WCHAR*

包含字体系列名称的字符数组

fontCollection

类型: IDWriteFontCollection*

指向字体集合对象的指针。 如果为 NULL,则指示系统字体集合。

fontWeight

类型: DWRITE_FONT_WEIGHT

一个 值,该值指示此方法创建的文本对象的字体粗细。

fontStyle

类型: DWRITE_FONT_STYLE

一个 值,该值指示此方法创建的文本对象的字体样式。

fontStretch

类型: DWRITE_FONT_STRETCH

一个 值,该值指示此方法创建的文本对象的字体拉伸。

fontSize

类型: FLOAT

字体的逻辑大小,以 DIP(“与设备无关的像素”)为单位。 DIP 等于 1/96 英寸。

[in] localeName

类型: const WCHAR*

包含区域设置名称的字符数组。

[out] textFormat

类型: IDWriteTextFormat**

此方法返回时,包含指向新创建的文本格式对象的指针的地址,如果失败,则为 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