Freigeben über


Graphics::D rawPolygon(constPen*,constPoint*,INT)-Methode (gdiplusgraphics.h)

Die Graphics::D rawPolygon-Methode zeichnet ein Polygon.

Syntax

Status DrawPolygon(
  [in] const Pen   *pen,
  [in] const Point *points,
  [in] INT         count
);

Parameter

[in] pen

Typ: const Pen*

Zeiger auf einen Stift, der zum Zeichnen des Polygons verwendet wird.

[in] points

Typ: const Point*

Zeiger auf ein Array von Point-Objekten , die die Scheitelpunkte des Polygons angeben.

[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

Wenn die erste und die letzte Koordinate im Punktarray nicht identisch sind, wird eine Linie zwischen ihnen gezeichnet, um das Polygon zu schließen.

Beispiele

Im folgenden Beispiel wird ein Polygon zeichnert, das durch ein Array von Punkten definiert wird.

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

   // Create a Pen object.
   Pen blackPen(Color(255, 0, 0, 0), 3);

   // Create an array of Point objects that define the polygon.
   Point point1(100, 100);
   Point point2(200, 130);
   Point point3(150, 200);
   Point point4(50, 200);
   Point point5(0, 130);
   Point points[5] = {point1, point2, point3, point4, point5};
   Point* pPoints = points;

   // Draw the polygon.
   graphics.DrawPolygon(&blackPen, pPoints, 5);
}

Anforderungen

   
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 gdiplusgraphics.h (include Gdiplus.h)
Bibliothek Gdiplus.lib
DLL Gdiplus.dll

Weitere Informationen

FillPolygon-Methoden

Grafiken

Point

Polygone