Метод ID2D1DeviceContext4::D rawTextLayout (d2d1_3.h)

Статья
08/22/2023

Рисует объект текстового макета. Если макет впоследствии не изменяется, это может быть более эффективным, чем 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. Это означает, что текст должен быть прикреплен к границам пикселей и не должен обрезаться в прямоугольнике макета.

Возвращаемое значение

None

Требования


Целевая платформа	Windows
Header	d2d1_3.h
DLL	D2d1.dll

См. также раздел

ID2D1DeviceContext4

Поделиться через