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

Artikel
07/16/2024

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

Syntax

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

Parameter

points

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

count

Ganze Zahl, die die Anzahl der Elemente im Punktarray angibt.

Rückgabewert

Typ:Status

Wenn die Methode erfolgreich ist, wird Ok zurückgegeben, bei dem es sich um ein Element der Status Enumeration handelt.

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

Bemerkungen

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

Beispiele

Im folgenden Beispiel wird ein GraphicsPath Objektpfad erstellt, ein Polygon zum Pfad hinzugefügt und dann der Pfad bezieht.

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