GraphicsPath::AddPath-Methode (gdipluspath.h)

Artikel
02/26/2024

Die GraphicsPath::AddPath-Methode fügt diesem Pfad einen Pfad hinzu.

Syntax

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

Parameter

[in] addingPath

Typ: const GraphicsPath*

Zeiger auf den hinzuzufügenden Pfad.

[in] connect

Typ: BOOL

BOOL-Wert , der angibt, ob die erste Abbildung im hinzugefügten Pfad Teil der letzten Abbildung in diesem Pfad ist.

true

Gibt an, dass (falls möglich) die erste Abbildung im hinzugefügten Pfad Teil der letzten Abbildung in diesem Pfad ist.

FALSE

Gibt an, dass die erste Abbildung im hinzugefügten Pfad von der letzten Abbildung in diesem Pfad getrennt ist.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Auch wenn der Wert des Connect-ParametersTRUE ist, kann diese Methode möglicherweise nicht in der Lage sein, die erste Abbildung des hinzugefügten Pfads als Teil der letzten Abbildung dieses Pfads zu machen. Wenn eine dieser Zahlen geschlossen ist, müssen sie separate Zahlen bleiben.

Beispiele

Im folgenden Beispiel werden zwei GraphicsPath-Objekte erstellt: path1 und path2. Der Code fügt jedem Pfad eine offene Abbildung hinzu, die aus einem Bogen und einem Bézier-Spline besteht. Der Code ruft die GraphicsPath::AddPath-Methode von path1 auf, um path1 path2 hinzuzufügen. Das zweite Argument ist TRUE, das angibt, dass alle vier Elemente (zwei Bögen und zwei Bézier-Splines) zu derselben Abbildung gehören.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdipluspath.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll