ID2D1RenderTarget：:D rawText (constWCHAR，UINT32，IDWriteTextFormat，constD2D1_RECT_F&，ID2D1Brush*，D2D1_DRAW_TEXT_OPTIONS，DWRITE_MEASURING_MODE) 方法 (d2d1.h)

项目
01/10/2024

使用 IDWriteTextFormat 对象提供的格式信息绘制指定的文本。

语法

void DrawText(
  [in]  const WCHAR            *string,
        UINT32                 stringLength,
  [in]  IDWriteTextFormat      *textFormat,
  [ref] const D2D1_RECT_F &    layoutRect,
  [in]  ID2D1Brush             *defaultFillBrush,
        D2D1_DRAW_TEXT_OPTIONS options,
        DWRITE_MEASURING_MODE  measuringMode
);

参数

[in] string

类型： WCHAR*

指向要绘制的 Unicode 字符数组的指针。

stringLength

类型： UINT

字符串中的字符数。

[in] textFormat

类型： IDWriteTextFormat*

一个对象，描述要绘制的文本的格式详细信息，例如字体、字号和流方向。

[ref] layoutRect

类型： const D2D1_RECT_F

在其中绘制文本的区域的大小和位置。

[in] defaultFillBrush

类型： ID2D1Brush*

用于绘制文本的画笔。

options

类型： D2D1_DRAW_TEXT_OPTIONS

一个值，指示是否应将文本对齐到像素边界，以及是否应将文本剪裁到布局矩形。默认值为 D2D1_DRAW_TEXT_OPTIONS_NONE，指示文本应贴靠到像素边界，并且不应剪裁到布局矩形。

measuringMode

类型： DWRITE_MEASURING_MODE

一个值，该值指示在设置格式时如何使用字形指标来度量文本。默认值为 DWRITE_MEASURING_MODE_NATURAL。

返回值

无

备注

若要创建 IDWriteTextFormat 对象，请创建 IDWriteFactory 并调用其 CreateTextFormat 方法。

如果此方法失败，则不会返回错误代码。若要确定绘图操作 (（如 DrawText) ）是否失败，检查 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