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