Freigeben über


CreatePolyPolygonRgn-Funktion (wingdi.h)

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

Weitere Informationen

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

DeleteObject

ExtCreateRegion

GetRegionData

PUNKT

Regionsfunktionen

Übersicht über Regionen

Auswählenobjekt

SetPolyFillMode