CreatePolyPolygonRgn-Funktion (wingdi.h)

Artikel
08/27/2023

Die CreatePolyPolygonRgn-Funktion erstellt einen Bereich, der aus einer Reihe von Polygonen besteht. Die Polygone können sich überlappen.

Syntax

HRGN CreatePolyPolygonRgn(
  [in] const POINT *pptl,
  [in] const INT   *pc,
  [in] int         cPoly,
  [in] int         iMode
);

Parameter

[in] pptl

Ein Zeiger auf ein Array von POINT-Strukturen , die die Scheitelpunkte der Polygone in logischen Einheiten definieren. Die Polygone werden nacheinander angegeben. Jedes Polygon wird als geschlossen angenommen, und jeder Scheitelpunkt wird nur einmal angegeben.

[in] pc

Ein Zeiger auf ein Array ganzzahliger Zahlen, von denen jede die Anzahl von Punkten in einem der Polygone im Array angibt, auf das mit lppt verwiesen wird.

[in] cPoly

Die Gesamtzahl der ganzen Zahlen im Array, auf die von lpPolyCounts verwiesen wird.

[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 die Funktion fehlerhaft ist, 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.

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