Freigeben über


CreatePolygonRgn-Funktion (wingdi.h)

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

Weitere Informationen

CreatePolyPolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

DeleteObject

ExtCreateRegion

GetRegionData

PUNKT

Regionsfunktionen

Übersicht über Regionen

Auswählenobjekt

SetPolyFillMode