ID2D1DeviceContext4::D rawTextLayout 方法 (d2d1_3.h)

绘制文本布局对象。 如果布局随后未更改,则重复绘制相同布局时,这比 DrawText 更高效。

语法

void DrawTextLayout(
                 D2D1_POINT_2F          origin,
  [in]           IDWriteTextLayout      *textLayout,
  [in, optional] ID2D1Brush             *defaultFillBrush,
  [in, optional] ID2D1SvgGlyphStyle     *svgGlyphStyle,
                 UINT32                 colorPaletteIndex,
                 D2D1_DRAW_TEXT_OPTIONS options
);

参数

origin

类型: D2D1_POINT_2F

以与设备无关的像素描述的点,其中绘制 由 textLayout 描述的文本的左上角。

[in] textLayout

类型: IDWriteTextLayout*

要绘制的格式化文本。 忽略任何不继承自 ID2D1Resource 的绘图效果。 如果从 ID2D1Resource 继承的绘图效果不是画笔,则此方法将失败,并且呈现器目标处于错误状态。

[in, optional] defaultFillBrush

类型: ID2D1Brush*

用于绘制文本的画笔。

[in, optional] svgGlyphStyle

类型: ID2D1SvgGlyphStyle*

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

colorPaletteIndex

类型: UINT32

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

options

类型: D2D1_DRAW_TEXT_OPTIONS

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

返回值

要求

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

另请参阅

ID2D1DeviceContext4