CreateRectRgn-Funktion (wingdi.h)
Die CreateRectRgn-Funktion erstellt einen rechteckigen Bereich.
Syntax
HRGN CreateRectRgn(
[in] int x1,
[in] int y1,
[in] int x2,
[in] int y2
);
Parameter
[in] x1
Gibt die x-Koordinate der oberen linken Ecke des Bereichs in logischen Einheiten an.
[in] y1
Gibt die y-Koordinate der oberen linken Ecke des Bereichs in logischen Einheiten an.
[in] x2
Gibt die x-Koordinate der unteren rechten Ecke des Bereichs in logischen Einheiten an.
[in] y2
Gibt die y-Koordinate der unteren rechten Ecke des Bereichs in logischen Einheiten an.
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.
Bereiche, die von den<Create shape>Rgn-Methoden (z. B. CreateRectRgn und CreatePolygonRgn) erstellt wurden, enthalten nur das Innere der Form. Die Kontur des Shapes wird vom Bereich ausgeschlossen. Dies bedeutet, dass jeder Punkt auf einer Linie zwischen zwei sequenziellen Scheitelpunkten nicht in der Region enthalten ist. Wenn Sie PtInRegion für einen solchen Punkt aufrufen würden, würde es als Ergebnis 0 (null) zurückgeben.
Beispiele
Ein Beispiel finden Sie unter Zeichnen von Markern.
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 (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |