GetWindowRgnBox-Funktion (winuser.h)

Artikel
03/06/2024

Die GetWindowRgnBox-Funktion ruft die Abmessungen des engsten begrenzungsenden Rechtecks für den Fensterbereich eines Fensters ab.

Syntax

int GetWindowRgnBox(
  [in]  HWND   hWnd,
  [out] LPRECT lprc
);

Parameter

[in] hWnd

Handle zum Fenster.

[out] lprc

Zeiger auf eine RECT-Struktur , die die Rechteckdimensionen in Geräteeinheiten relativ zur oberen linken Ecke des Fensters empfängt.

Rückgabewert

Der Rückgabewert gibt den Typ des Bereichs an, den die Funktion abruft. Dieses Argument einen der folgenden Werte annehmen.

Wert	Bedeutung
KOMPLEXE REGION	Der Bereich ist mehr als ein Rechteck.
ERROR	Das angegebene Fenster weist keine Region auf, oder beim Versuch, die Region zurückzugeben, ist ein Fehler aufgetreten.
NULLREGION	Der Bereich ist leer.
SIMPLEREGION	Die Region ist ein einzelnes Rechteck.

Hinweise

Der Fensterbereich bestimmt den Bereich innerhalb des Fensters, in dem das System das Zeichnen zulässt. Das System zeigt keinen Teil eines Fensters an, der außerhalb des Fensterbereichs liegt. Die Koordinaten des Fensterbereichs eines Fensters sind relativ zur oberen linken Ecke des Fensters, nicht zum Clientbereich des Fensters.

Um den Fensterbereich eines Fensters festzulegen, rufen Sie die SetWindowRgn-Funktion auf.

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	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-draw-l1-1-0 (eingeführt in Windows 8)