МЕТОД ID2D1RenderTarget::D rawText(constWCHAR,UINT32,IDWriteTextFormat,constD2D1_RECT_F&,ID2D1Brush*,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE) (d2d1.h)

Статья
08/22/2023

Рисует указанный текст, используя сведения о формате, предоставляемые объектом IDWriteTextFormat .

Синтаксис

void DrawText(
  [in]  const WCHAR            *string,
        UINT32                 stringLength,
  [in]  IDWriteTextFormat      *textFormat,
  [ref] const D2D1_RECT_F &    layoutRect,
  [in]  ID2D1Brush             *defaultFillBrush,
        D2D1_DRAW_TEXT_OPTIONS options,
        DWRITE_MEASURING_MODE  measuringMode
);

Параметры

[in] string

Тип: WCHAR*

Указатель на массив символов Юникода для рисования.

stringLength

Тип: UINT

Количество символов в строке.

[in] textFormat

Тип: IDWriteTextFormat*

Объект , описывающий детали форматирования текста для рисования, такие как шрифт, размер шрифта и направление потока.

[ref] layoutRect

Тип: const D2D1_RECT_F

Размер и положение области, в которой рисуется текст.

[in] defaultFillBrush

Тип: ID2D1Brush*

Кисть, используемая для рисования текста.

options

Тип: D2D1_DRAW_TEXT_OPTIONS

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

measuringMode

Тип: DWRITE_MEASURING_MODE

Значение типа , указывающее, как метрики глифов используются для измерения текста при его форматировании. Значение по умолчанию — DWRITE_MEASURING_MODE_NATURAL.

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

None

Remarks

Чтобы создать объект IDWriteTextFormat , создайте IDWriteFactory и вызовите его метод CreateTextFormat .

Этот метод не возвращает код ошибки в случае сбоя. Чтобы определить, завершилась ли операция рисования (например, DrawText), проверка результат, возвращаемый методами 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