GraphicsPath::AddString(constWCHAR,INT,constFontFamily,INT,REAL,constPointF&,constStringFormat*) (gdipluspath.h)

Статья
07/16/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-terminated, этот параметр может иметь значение –1.

family

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

style

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

emSize

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

origin

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

format

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

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

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

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

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

Замечания

Обратите внимание, что GDI+ не поддерживает шрифты PostScript или шрифты OpenType, которые не имеют контуров TrueType.

Примеры

В следующем примере создается путь объекта GraphicsPath, добавляет в путь строку, завершаемую null, а затем рисует путь.

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);
}