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

Artikel
03/01/2024

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

Syntax

Status AddPolygon(
  const PointF *points,
  INT          count
);

Parameter

points

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

count

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

   PointF pts[] = {PointF(20.0f, 20.0f),
                   PointF(120.0f, 20.0f),
                   PointF(120.0f, 70.0f)};

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

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