Share via

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内部版本 20348
最低受支持的服务器 Windows 10内部版本 20348
目标平台 Windows
标头 dwrite_3.h
Library Dwrite.lib