CreateRectRgn-Funktion (wingdi.h)

Artikel
03/06/2024

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