通过

IDWriteFactory6：：CreateTextFormat 方法 （dwrite_3.h）

  • 项目

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

语法

HRESULT CreateTextFormat(
  WCHAR const                  *fontFamilyName,
  IDWriteFontCollection        *fontCollection,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  FLOAT                        fontSize,
  WCHAR const                  *localeName,
  IDWriteTextFormat3           **textFormat
);

参数

fontFamilyName

类型：WCHAR const *

集合中字体系列的名称。

fontCollection

类型：IDWriteFontCollection*

字体集合。 使用 nullptr 来指示系统字体集合。

fontAxisValues

类型：DWRITE_FONT_AXIS_VALUE const *

指向包含字体轴值列表的数组的指针。 数组应为 fontAxisValueCount 参数指示的大小（元素数）。

fontAxisValueCount

类型：UINT32

fontAxisValues 数组中包含的字体轴值数。

fontSize

类型：FLOAT

DIP 单位中字体的逻辑大小。

localeName

类型：WCHAR const *

区域设置名称（例如，“ja-JP”、“en-US”、“ar-EG”）。

textFormat

类型：IDWriteTextFormat3**

指向 IDWriteTextFormat3 接口的指针的地址。 成功完成后，该函数将指针设置为新创建的文本格式对象，否则它将指针设置为 nullptr。

返回值

类型：HRESULT

如果函数成功，则返回 S_OK。 否则，它将返回 HRESULT错误代码。

言论

如果 fontCollection 为 nullptr，则使用系统字体集合，按版式系列名称（DWRITE_FONT_FAMILY_MODEL_TYPOGRAPHIC）分组，不带可下载字体。

要求

要求 价值
最低支持的客户端 Windows 10 内部版本 16299
支持的最低服务器 Windows 10 内部版本 16299
目标平台 窗户
标头 dwrite_3.h
库 Dwrite.lib