Метод Graphics::D rawDriverString (gdiplusgraphics.h)

Статья
02/23/2024

Метод Graphics::D rawDriverString рисует символы в указанных позициях. Метод предоставляет клиенту полный контроль над внешним видом текста. Метод предполагает, что клиент уже настроил применяемый формат и макет.

Синтаксис

Status DrawDriverString(
  [in] const UINT16 *text,
  [in] INT          length,
  [in] const Font   *font,
  [in] const Brush  *brush,
  [in] const PointF *positions,
  [in] INT          flags,
  [in] const Matrix *matrix
);

Параметры

[in] text

Тип: const UINT16*

Указатель на массив 16-разрядных значений. Если установлен флаг DriverStringOptionsCmapLookup , каждое значение указывает отображаемый символ Юникода. В противном случае каждое значение задает индекс глифа шрифта, который определяет отображаемый символ.

[in] length

Тип: INT

Целое число, указывающее количество значений в текстовом массиве. Параметр length может иметь значение –1, если строка завершается null.

[in] font

Тип: const Font*

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

[in] brush

Тип: const Brush*

Указатель на объект Brush , используемый для заполнения строки.

[in] positions

Тип: const PointF*

Если установлен флаг DriverStringOptionsRealizedAdvance , position — это указатель на объект PointF , указывающий положение первого глифа. В противном случае позиции — это массив объектов PointF , каждый из которых указывает источник отдельного глифа.

[in] flags

Тип: INT

Целое число, указывающее параметры внешнего вида строки. Это значение должно быть элементом перечисления DriverStringOptions или результатом побитовой операции OR , примененной к двум или более из этих элементов.

[in] matrix

Тип: const Matrix*

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

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

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .

Этот метод не поддерживает обработку сложных скриптов и предполагает, что клиент настроил весь макет текста каким-то другим способом. Этот метод полезен для создания элементов меню, нарисованных владельцем. Клиент должен использовать метод DrawString Methods в общих целях.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP, Windows 2000 Профессиональная [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdiplusgraphics.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll