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 |