Share via

IDWriteFactory：：CreateGdiCompatibleTextLayout 方法 (dwrite.h)

  • 项目

采用字符串、格式和关联的约束，并生成一个对象，该对象表示结果，针对特定的显示分辨率和测量模式设置格式。

语法

HRESULT CreateGdiCompatibleTextLayout(
  [in]           WCHAR const         *string,
                 UINT32              stringLength,
                 IDWriteTextFormat   *textFormat,
                 FLOAT               layoutWidth,
                 FLOAT               layoutHeight,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
  [out]          IDWriteTextLayout   **textLayout
);

参数

[in] string

类型： const WCHAR*

包含要从中创建新 IDWriteTextLayout 对象的字符串的字符数组。 此数组的长度必须为 stringLength ，可以包含嵌入 的 NULL 字符。

stringLength

类型： UINT32

字符串的长度（以字符计数为单位）。

textFormat

类型： IDWriteTextFormat*

要应用于字符串的文本格式对象。

layoutWidth

类型： FLOAT

布局框的宽度。

layoutHeight

类型： FLOAT

布局框的高度。

pixelsPerDip

类型： FLOAT

每个 DIP 的物理像素数 (设备无关像素) 。 例如，如果呈现到 96 DPI 设备 像素上，则PerDip 为 1。 如果呈现到 120 DPI 设备 像素PerDip 为 1.25 (120/96) 。

[in, optional] transform

类型： const DWRITE_MATRIX*

应用于字形及其位置的可选转换。 此转换在缩放指定每个 DIP 的字体大小和像素之后应用。

useGdiNatural

类型： BOOL

指示文本布局在设置为 FALSE 时使用与 GDI 双级文本相同的指标。 如果设置为 TRUE，则指示文本布局使用与使用 CLEARTYPE_NATURAL_QUALITY 创建的字体由 GDI 测量的文本使用相同的指标。

[out] textLayout

类型： IDWriteTextLayout**

此方法返回时，包含指向结果文本布局对象的指针的地址。

返回值

类型： HRESULT

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

注解

生成的文本布局应仅用于预期分辨率，并且对于需要文本可伸缩性的情况，应改用 CreateTextLayout 。

要求

要求 值
最低受支持的客户端 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