ID2D1RenderTarget：:D rawTextLayout 方法 (d2d1.h)
绘制由指定的 IDWriteTextLayout 对象描述的格式化文本。
语法
void DrawTextLayout(
D2D1_POINT_2F origin,
[in] IDWriteTextLayout *textLayout,
[in] ID2D1Brush *defaultFillBrush,
D2D1_DRAW_TEXT_OPTIONS options
);
参数
origin
类型： D2D1_POINT_2F
以与设备无关的像素描述的点，其中绘制 由 textLayout 描述的文本的左上角。
[in] textLayout
类型： IDWriteTextLayout*
要绘制的格式化文本。 忽略任何不继承自 ID2D1Resource 的绘图效果。 如果从 ID2D1Resource 继承的绘图效果不是画笔，则此方法将失败，并且呈现器目标处于错误状态。
[in] defaultFillBrush
类型： ID2D1Brush*
用于在 textLayout 中绘制尚未将画笔关联的任何文本作为绘制效果的画笔 (由 IDWriteTextLayout：：SetDrawingEffect 方法指定的) 。
options
一个值，指示是否应将文本对齐到像素边界，以及是否应将文本剪裁到布局矩形。 默认值为 D2D1_DRAW_TEXT_OPTIONS_NONE，指示文本应贴靠到像素边界，并且不应将其剪裁到布局矩形。
返回值
无
备注
当重复绘制相同的文本时，使用 DrawTextLayout 方法比使用 DrawText 方法更高效，因为不需要设置文本的格式，并且布局与每次调用一起处理。
如果此方法失败，此方法不会返回错误代码。 若要确定绘图操作 (（如 DrawTextLayout) ）是否失败，检查 ID2D1RenderTarget：：EndDraw 或 ID2D1RenderTarget：：Flush 方法返回的结果。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | d2d1.h |
| Library | D2d1.lib |
| DLL | D2d1.dll |