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

Статья
08/24/2023

Метод Graphics::MeasureDriverString измеряет ограничивающий прямоугольник для указанных символов и их соответствующих положений.

Синтаксис

Status MeasureDriverString(
  [in]  const UINT16 *text,
  [in]  INT          length,
  [in]  const Font   *font,
  [in]  const PointF *positions,
  [in]  INT          flags,
  [in]  const Matrix *matrix,
  [out] RectF        *boundingBox
);

Параметры

[in] text

Тип: const UINT16*

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

[in] length

Тип: INT

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

[in] font

Тип: константный шрифт*

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

[in] positions

Тип: const PointF*

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

[in] flags

Тип: INT

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

[in] matrix

Тип: const Matrix*

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

[out] boundingBox

Тип: RectF*

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

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

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

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

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

Требования

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