Поделиться через


Graphics::MeasureString(constWCHAR*,INT,constFont*,constRectF&,RectF*) (gdiplusgraphics.h)

Метод Graphics::MeasureString измеряет экстент строки в указанном прямоугольнике шрифта и макета.

Синтаксис

Status MeasureString(
  [in]      const WCHAR   *string,
  [in]      INT           length,
  [in]      const Font    *font,
  [in, ref] const RectF & layoutRect,
  [out]     RectF         *boundingBox
);

Параметры

[in] string

Тип: const WCHAR*

Указатель на измеримую строку с расширенными символами.

Важно Для двунаправленных языков, таких как арабский, длина строки не должна превышать 2046 символов.
 

[in] length

Тип: INT

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

[in] font

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

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

[in, ref] layoutRect

Тип: const RectF

Ссылка на прямоугольник, ограничивающий строку.

[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

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

Методы DrawString

Шрифт

Графика

RectF