Метод ID2D1DeviceContext4::D rawText(constWCHAR*,UINT32,IDWriteTextFormat*,constD2D1_RECT_F*,ID2D1Brush*,ID2D1SvgGlyphStyle*,UINT32,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE) (d2d1_3.h)

  • Статья

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

По умолчанию этот метод выполняет базовое прикрепление и отрисовывает цветовые версии глифов в цветных шрифтах.

Синтаксис

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

Параметры

[in] string

Тип: const WCHAR*

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

stringLength

Тип: UINT32

Число символов в строке.

[in] textFormat

Тип: IDWriteTextFormat*

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

[in] layoutRect

Тип: const D2D1_RECT_F*

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

[in, optional] defaultFillBrush

Тип: ID2D1Brush*

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

[in, optional] svgGlyphStyle

Тип: ID2D1SvgGLyphStyle*

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

colorPaletteIndex

Тип: UINT32

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

options

Тип: D2D1_DRAW_TEXT_OPTIONS

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

measuringMode

Тип: DWRITE_MEASURING_MODE

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

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

None

Требования

Требование Значение
Целевая платформа Windows
Header d2d1_3.h
DLL D2d1.dll

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

ID2D1DeviceContext4