Метод GraphicsPath::AddPath (gdipluspath.h)

Статья
02/29/2024

Метод GraphicsPath::AddPath добавляет путь к этому пути.

Синтаксис

Status AddPath(
  [in] const GraphicsPath *addingPath,
  [in] BOOL               connect
);

Параметры

[in] addingPath

Тип: const GraphicsPath*

Указатель на добавляемый путь.

[in] connect

Тип: BOOL

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

TRUE

Указывает, что (по возможности) первый рисунок в добавленном пути является частью последнего рисунка в этом пути.

Ложь.

Указывает, что первый рисунок в добавленном пути отделен от последнего рисунка в этом пути.

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

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

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

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

Даже если значение параметра connect равно TRUE, этот метод может не сделать первый рисунок добавленного пути частью последнего рисунка этого пути. Если любая из этих фигур закрыта, то они должны оставаться отдельными фигурами.

Примеры

В следующем примере создаются два объекта GraphicsPath : path1 и path2. Код добавляет к каждому пути открытую фигуру, состоящую из дуги и сплайна Безье. Код вызывает метод GraphicsPath::AddPathобъекта path1 , чтобы добавить path2 в path1. Второй аргумент — TRUE, который указывает, что все четыре элемента (две дуги и два сплайна Безье) принадлежат одной и той же фигуре.

VOID AddPathExample(HDC hdc)
{
   Graphics graphics(hdc);

   GraphicsPath path1;
   path1.AddArc(10, 10, 50, 20, 0.0f, 150.0f);
   path1.AddBezier(10, 50, 60, 50, 10, 80, 60, 80);
   
   GraphicsPath path2;
   path2.AddArc(10, 110, 50, 20, 0.0f, 150.0f);
   path2.AddBezier(10, 150, 60, 150, 10, 180, 60, 180);
 
   path1.AddPath(&path2, TRUE);

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

Требования

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