CreatePolygonRgn-Funktion (wingdi.h)

Artikel
08/27/2023

Die CreatePolygonRgn-Funktion erstellt einen polygonalen Bereich.

Syntax

HRGN CreatePolygonRgn(
  [in] const POINT *pptl,
  [in] int         cPoint,
  [in] int         iMode
);

Parameter

[in] pptl

Ein Zeiger auf ein Array von POINT-Strukturen , die die Scheitelpunkte des Polygons in logischen Einheiten definieren. Das Polygon wird als geschlossen angenommen. Jeder Scheitelpunkt kann nur einmal angegeben werden.

[in] cPoint

Die Anzahl der Punkte im Array.

[in] iMode

Der Füllmodus, der verwendet wird, um zu bestimmen, welche Pixel sich in der Region befinden. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
ALTERNATIVE	Wählt den alternativen Modus aus (füllt den Bereich zwischen ungeraden und geraden Polygonseiten auf jeder Scanlinie aus).
WICKLUNG	Wählt den Wickelmodus aus (füllt jede Region mit einem nichtzero-Wickelwert aus).

Weitere Informationen zu diesen Modi finden Sie in der SetPolyFillMode-Funktion .

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für die Region.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

Wenn Sie das HRGN-Objekt nicht mehr benötigen, rufen Sie die DeleteObject-Funktion auf, um es zu löschen.

Regionskoordinaten werden als 27-Bit-Ganzzahlen mit Vorzeichen dargestellt.

Regionen, die von den<Create shape>Rgn-Methoden (z. B . CreateRectRgn und CreatePolygonRgn) erstellt wurden, enthalten nur das Innere der Form. Die Gliederung der Form wird aus der Region ausgeschlossen. Dies bedeutet, dass kein Punkt auf einer Linie zwischen zwei sequenziellen Scheitelpunkten in der Region enthalten ist. Wenn Sie PtInRegion für einen solchen Punkt aufrufen würden, würde dies null zurückgeben.

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