ID2D1DeviceContext4::D rawText (constWCHAR*,UINT32,IDWriteTextFormat*,constD2D1_RECT_F*,ID2D1Brush*,ID2D1SvgGlyphStyle*,UINT32,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE) 方法 (d2d1_3.h)

在给定布局矩形内绘制文本。

默认情况下,此方法执行基线贴靠,并用彩色字体呈现字形的颜色版本。

语法

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

参数

[in] string

类型: const WCHAR*

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

stringLength

类型: UINT32

字符串中的字符数。

[in] textFormat

类型: IDWriteTextFormat*

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

[in] layoutRect

类型: const D2D1_RECT_F*

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

[in, optional] defaultFillBrush

类型: ID2D1Brush*

用于绘制文本的画笔。

[in, optional] svgGlyphStyle

类型: ID2D1SvgGlyphStyle*

呈现 SVG 字形时使用的上下文填充、上下文笔划和上下文值的值。

colorPaletteIndex

类型: UINT32

用于在颜色字体中选择调色板的索引。

options

类型: D2D1_DRAW_TEXT_OPTIONS

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

measuringMode

类型: DWRITE_MEASURING_MODE

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

返回值

要求

要求
目标平台 Windows
标头 d2d1_3.h
DLL D2d1.dll

另请参阅

ID2D1DeviceContext4