Метод GraphicsPath::AddString(constWCHAR,INT,constFontFamily,INT,REAL,constRect&,constStringFormat*) (gdipluspath.h)

Статья
02/29/2024

Метод GraphicsPath::AddString добавляет структуру строки в этот путь.

Синтаксис

Status AddString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const FontFamily   *family,
  [in]      INT                style,
  [in]      REAL               emSize,
  [in, ref] const Rect &       layoutRect,
  [in]      const StringFormat *format
);

Параметры

[in] string

Тип: const WCHAR*

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

[in] length

Тип: INT

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

[in] family

Тип: const FontFamily*

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

[in] style

Тип: INT

Целое число, задающее стиль шрифта. Это значение должно быть элементом перечисления FontStyle или результатом побитовой операции OR , примененной к двум или более из этих элементов. Например, FontStyleBold | FontStyleUnderline | FontStyleStrikeout задает стиль как сочетание трех стилей.

[in] emSize

Тип: REAL

Вещественное число, указывающее размер строковых символов в единицах мира.

[in, ref] layoutRect

Тип: const Rect

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

[in] format

Тип: const StringFormat*

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

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

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

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

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

VOID Example_AddString(HDC hdc)
{
   Graphics graphics(hdc);
   FontFamily fontFamily(L"Times New Roman");
   GraphicsPath path;

   path.AddString(
      L"Hello World", 
      -1,                 // NULL-terminated string
      &fontFamily, 
      FontStyleRegular, 
      48, 
      Rect(50, 50, 150, 100),
      NULL);

   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

Требования

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