GetWindowRgn-Funktion (winuser.h)
Die GetWindowRgn-Funktion ruft eine Kopie des Fensterbereichs eines Fensters ab. Der Fensterbereich eines Fensters wird durch Aufrufen der SetWindowRgn-Funktion festgelegt. 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 sich außerhalb des Fensterbereichs befindet.
Syntax
int GetWindowRgn(
[in] HWND hWnd,
[in] HRGN hRgn
);
Parameter
[in] hWnd
Handle für das Fenster, dessen Fensterbereich abgerufen werden soll.
[in] hRgn
Handle für die Region, die geändert wird, um den Fensterbereich darzustellen.
Rückgabewert
Der Rückgabewert gibt den Typ der Region an, die die Funktion abruft. Dieses Argument einen der folgenden Werte annehmen.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Region ist leer. |
|
Die Region ist ein einzelnes Rechteck. |
|
Die Region ist mehr als ein Rechteck. |
|
Das angegebene Fenster weist keine Region auf, oder beim Versuch, die Region zurückzugeben, ist ein Fehler aufgetreten. |
Hinweise
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 Funktion SetWindowRgn auf.
Beispiele
Der folgende Code zeigt, wie Sie das Handle einer vorhandenen Region übergeben.
HRGN hrgn = CreateRectRgn(0,0,0,0);
int regionType = GetWindowRgn(hwnd, hrgn);
if (regionType != ERROR)
{
/* hrgn contains window region */
}
DeleteObject(hrgn); /* finished with region */
Anforderungen
| 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 (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-draw-l1-1-2 (eingeführt in Windows 10, Version 10.0.10240) |