PolyPolygon-Funktion (wingdi.h)

Artikel
03/04/2024

Die PolyPolygon-Funktion zeichnet eine Reihe geschlossener Polygone. Jedes Polygon wird mithilfe des aktuellen Stifts umrissen und mit dem aktuellen Pinsel- und Polygonfüllmodus gefüllt. Die von dieser Funktion gezeichneten Polygone können sich überlappen.

Syntax

BOOL PolyPolygon(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] const INT   *asz,
  [in] int         csz
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] apt

Ein Zeiger auf ein Array von POINT-Strukturen , die die Scheitelpunkte der Polygone in logischen Koordinaten definieren. Die Polygone werden nacheinander angegeben. Jedes Polygon wird automatisch geschlossen, indem eine Linie vom letzten Scheitelpunkt zum ersten gezeichnet wird. Jeder Scheitelpunkt sollte einmal angegeben werden.

[in] asz

Ein Zeiger auf ein Array von ganzen Zahlen, von denen jede die Anzahl der Punkte im entsprechenden Polygon angibt. Jede ganze Zahl muss größer oder gleich 2 sein.

[in] csz

Die Gesamtanzahl der Polygone.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Die aktuelle Position wird von dieser Funktion weder verwendet noch aktualisiert.

Alle zusätzlichen Punkte werden ignoriert. Um die Polygone mit mehr Punkten zu zeichnen, teilen Sie Ihre Daten in Gruppen auf, die jeweils weniger als die maximale Anzahl von Punkten aufweisen, und rufen Sie die Funktion für jede Gruppe von Punkten auf. Beachten Sie, dass es am besten ist, ein Polygon nur in einer der Gruppen zu verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll