GraphicsPath::AddPolygon(constPoint*,INT)-Methode (gdipluspath.h)
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 |