Метод ID2D1RenderTarget::D rawTextLayout (d2d1.h)

Статья
08/22/2023

Рисует отформатированный текст, описываемый указанным объектом IDWriteTextLayout .

Синтаксис

void DrawTextLayout(
       D2D1_POINT_2F          origin,
  [in] IDWriteTextLayout      *textLayout,
  [in] ID2D1Brush             *defaultFillBrush,
       D2D1_DRAW_TEXT_OPTIONS options
);

Параметры

origin

Тип: D2D1_POINT_2F

Точка, описанная в независимых от устройства пикселях, в которой рисуется левый верхний угол текста, описанного textLayout .

[in] textLayout

Тип: IDWriteTextLayout*

Отформатированный текст для рисования. Все эффекты рисования, которые не наследуются от ID2D1Resource , игнорируются. Если есть эффекты рисования, наследующие от ID2D1Resource , которые не являются кистью, этот метод завершается ошибкой и целевой объект отрисовки переводится в состояние ошибки.

[in] defaultFillBrush

Тип: ID2D1Brush*

Кисть, используемая для рисования любого текста в textLayout , с которым еще не связана кисть в качестве эффекта рисования (задается методом IDWriteTextLayout::SetDrawingEffect ).

options

Тип: D2D1_DRAW_TEXT_OPTIONS

Значение типа , указывающее, следует ли привязать текст к границам пикселей и обрезать ли текст в прямоугольнике макета. Значение по умолчанию — D2D1_DRAW_TEXT_OPTIONS_NONE, что означает, что текст должен быть прикреплен к границам пикселей и не должен обрезаться в прямоугольнике макета.

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

None

Remarks

При многократном рисовании одного и того же текста использование метода DrawTextLayout является более эффективным, чем метод DrawText , так как текст не нужно форматировать и обрабатывать макет при каждом вызове.

Этот метод не возвращает код ошибки в случае сбоя. Чтобы определить, завершилась ли операция рисования (например, DrawTextLayout), проверка результат, возвращаемый методами ID2D1RenderTarget::EndDraw или ID2D1RenderTarget::Flush.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	d2d1.h
Библиотека	D2d1.lib
DLL	D2d1.dll

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

ID2D1RenderTarget

Форматирование текста и макет

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