CreateEllipticRgn-Funktion (wingdi.h)

Artikel
08/27/2023

Die CreateEllipticRgn-Funktion erstellt einen elliptischen Bereich.

Syntax

HRGN CreateEllipticRgn(
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2
);

Parameter

[in] x1

Gibt die x-Koordinate in logischen Einheiten der oberen linken Ecke des umgebenden Rechtecks der Ellipse an.

[in] y1

Gibt die y-Koordinate in logischen Einheiten der oberen linken Ecke des umgebenden Rechtecks der Ellipse an.

[in] x2

Gibt die x-Koordinate in logischen Einheiten der unteren rechten Ecke des umgebenden Rechtecks der Ellipse an.

[in] y2

Gibt die y-Koordinate in logischen Einheiten der unteren rechten Ecke des umgebenden Rechtecks der Ellipse 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.

Ein begrenzungsfähiges Rechteck definiert Größe, Form und Ausrichtung des Bereichs: Die langen Seiten des Rechtecks definieren die Länge der Hauptachse der Ellipse; die kurzen Seiten definieren die Länge der Nebenachse der Ellipse; und die Mitte des Rechtecks definiert den Schnittpunkt der Haupt- und Nebenachse.

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