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_NONE,指示文本应贴靠到像素边界,并且不应将其剪裁到布局矩形。
measuringMode
一个值,该值指示在设置格式时如何使用字形指标来度量文本。 默认值为 DWRITE_MEASURING_MODE_NATURAL。
返回值
无
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | d2d1_3.h |
DLL | D2d1.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈