GraphicsPath::AddPolygon(constPoint*,INT)-Methode (gdipluspath.h)

Artikel
02/27/2024

Die GraphicsPath::AddPolygon-Methode fügt diesem Pfad ein Polygon hinzu.

Syntax

Status AddPolygon(
  [in] const Point *points,
  [in] INT         count
);

Parameter

[in] points

Typ: const Point*

Zeiger auf ein Array von Punkten, das die Scheitelpunkte des Polygons angibt.

[in] count

Typ: INT

Ganzzahl, die die Anzahl der Elemente im Punktarray angibt.

Rückgabewert

Typ: Status

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

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Die GraphicsPath::AddPolygon-Methode ähnelt der AddLines-Methode . Der Unterschied besteht darin, dass ein Polygon eine intrinsisch geschlossene Figur ist, aber eine Folge von Linien keine geschlossene Abbildung ist, es sei denn, Sie rufen GraphicsPath::CloseFigure auf. Wenn Windows GDI+ einen Pfad rendert, wird jedes Polygon in diesem Pfad geschlossen. Das heißt, der letzte Scheitelpunkt des Polygons ist durch eine gerade Linie mit dem ersten Scheitelpunkt verbunden.

Beispiele

Das folgende Beispiel erstellt einen GraphicsPath-Objektpfad, fügt dem Pfad ein Polygon hinzu und zeichnet dann den Pfad.

VOID Example_AddPolygon(HDC hdc)
{
   Graphics graphics(hdc); 
 
   Point pts[] = {Point(20, 20),
                  Point(120, 20),
                  Point(120, 70)};

   GraphicsPath path;
   path.AddPolygon(pts, 3);

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

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