Метод IDWriteTextLayout::D raw (dwrite.h)

Рисует текст с использованием указанного контекста рисования клиента.

Синтаксис

HRESULT Draw(
  void                *clientDrawingContext,
  IDWriteTextRenderer *renderer,
  FLOAT               originX,
  FLOAT               originY
);

Параметры

clientDrawingContext

Тип: void*

Контекст рисования, определенный приложением.

renderer

Тип: IDWriteTextRenderer*

Указатель на набор функций обратного вызова, используемых для рисования частей текстовой строки.

originX

Тип: FLOAT

Координата X левой стороны макета.

originY

Тип: FLOAT

Координата Y верхней стороны макета.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Для рисования текста с помощью этого метода приложение должно создать объект textLayout с помощью IDWriteFactory::CreateTextLayout.

После получения объекта textLayout приложение вызывает метод IDWriteTextLayout::D raw для рисования текста, элементов оформления и встроенных объектов. Фактическое рисование выполняется через интерфейс обратного вызова, передаваемый в качестве аргумента textRenderer ; Там вызывается соответствующий API DrawGlyphRun .

Если задать вертикальное направление чтения текста в IDWriteTextLayout с помощью SetReadingDirection с DWRITE_READING_DIRECTION_TOP_TO_BOTTOM (или снизу вверх), необходимо передать интерфейс, реализующий IDWriteTextRenderer1. В противном случае вы получите ошибку DWRITE_E_TEXTRENDERERINCOMPATIBLE, так как исходный интерфейс IDWriteTextRenderer поддерживал только горизонтальный текст.

Требования

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

IDWriteTextLayout