Graphics::MeasureString(constWCHAR,INT,constFont,constSizeF&,constStringFormat,SizeF,INT,INT) (gdiplusgraphics.h)

Статья
01/10/2024

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

Синтаксис

Status MeasureString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const SizeF &      layoutRectSize,
  [in]      const StringFormat *stringFormat,
  [out]     SizeF              *size,
  [out]     INT                *codepointsFitted,
  [out]     INT                *linesFilled
);

Параметры

[in] string

Тип: const WCHAR*

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

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

[in] length

Тип: INT

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

[in] font

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

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

[in, ref] layoutRectSize

Тип: const SizeF

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

[in] stringFormat

Тип: const StringFormat*

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

[out] size

Тип: SizeF*

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

[out] codepointsFitted

Тип: INT*

Необязательный элемент. Указатель на INT , получающий количество символов, которые фактически помещаются в прямоугольник макета. Значением по умолчанию является указатель NULL .

[out] linesFilled

Тип: INT*

Необязательный элемент. Указатель на int , получающий количество строк, которые фактически помещаются в прямоугольник макета. Значением по умолчанию является указатель NULL .

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

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

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

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

Требования


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