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

一个值，指示是否应将文本对齐到像素边界，以及是否应将文本剪裁到布局矩形。 默认值为 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

另请参阅

ID2D1RenderTarget

文本格式和布局