Метод Graphics::MeasureString(constWCHAR,INT,constFont,constPointF&,constStringFormat,RectF) (gdiplusgraphics.h)

Статья
08/24/2023

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

Синтаксис

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

Параметры

[in] string

Тип: const WCHAR*

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

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

[in] length

Тип: INT

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

[in] font

Тип: const Font*

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

[in, ref] origin

Тип: const PointF

Ссылка на точку, с которой начинается строка.

[in] stringFormat

Тип: const StringFormat*

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

[out] boundingBox

Тип: RectF*

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

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

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

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

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

Требования


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