Share via

GetWindowRgn-Funktion (winuser.h)

  • Artikel

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
NULLREGION
 Die Region ist leer.
SIMPLEREGION
 Die Region ist ein einzelnes Rechteck.
COMPLEXREGION
 Die Region ist mehr als ein Rechteck.
ERROR
 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)

Weitere Informationen

Mal- und Zeichenfunktionen

Übersicht über Malerei und Zeichnung

SetWindowRgn