GetWindowRgnBox-Funktion (winuser.h)
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) |