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

Статья
01/10/2024

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

Синтаксис

Status AddString(
  const WCHAR        *string,
  INT                length,
  const FontFamily   *family,
  INT                style,
  REAL               emSize,
  const PointF &     origin,
  const StringFormat *format
);

Параметры

string

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

length

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

family

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

style

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

emSize

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

origin

Ссылка на объект PointF , указывающий в единицах мира расположение строки.

format

Указатель на объект 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, 
      PointF(50.0f, 50.0f),
      NULL);

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