Polygonfunktion (wingdi.h)

Artikel
08/27/2023

Die Polygonfunktion zeichnet ein Polygon, das aus zwei oder mehr Scheitelpunkten besteht, die durch gerade Linien verbunden sind. Das Polygon wird mithilfe des aktuellen Stifts umrissen und mit dem aktuellen Pinsel- und Polygonfüllmodus gefüllt.

Syntax

BOOL Polygon(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] int         cpt
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] apt

Ein Zeiger auf ein Array von POINT-Strukturen , die die Scheitelpunkte des Polygons in logischen Koordinaten angeben.

[in] cpt

Die Anzahl der Scheitelpunkte im Array. Dieser Wert muss größer oder gleich 2 sein.

Rückgabewert

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

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

Hinweise

Das Polygon wird automatisch geschlossen, indem eine Linie vom letzten Scheitelpunkt zum ersten gezeichnet wird.

Die aktuelle Position wird von der Polygon-Funktion weder verwendet noch aktualisiert.

Alle zusätzlichen Punkte werden ignoriert. Um eine Linie 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. Denken Sie daran, die Zeilensegmente zu verbinden.

Anforderungen


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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll