SetWindowRgn-Funktion (winuser.h)

Artikel
01/27/2024

Die SetWindowRgn-Funktion legt den Fensterbereich eines Fensters fest. 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 SetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bRedraw
);

Parameter

[in] hWnd

Ein Handle für das Fenster, dessen Fensterbereich festgelegt werden soll.

[in] hRgn

Ein Handle für eine Region. Die Funktion legt den Fensterbereich des Fensters auf diese Region fest.

Wenn hRgnNULL ist, legt die Funktion den Fensterbereich auf NULL fest.

[in] bRedraw

Gibt an, ob das System das Fenster nach dem Festlegen des Fensterbereichs neu zeichnet. Wenn bRedrawTRUE ist, wird dies vom System ausgeführt. andernfalls nicht.

In der Regel legen Sie bRedraw auf TRUE fest, wenn das Fenster sichtbar ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Wenn diese Funktion aufgerufen wird, sendet das System die WM_WINDOWPOSCHANGING und WM_WINDOWPOSCHANGED Nachrichten an das Fenster.

Die Koordinaten des Fensterbereichs eines Fensters sind relativ zur oberen linken Ecke des Fensters, nicht zum Clientbereich des Fensters.

Hinweis Wenn das Fensterlayout von rechts nach links (RTL) ist, sind die Koordinaten relativ zur oberen rechten Ecke des Fensters. Siehe Fensterlayout und Spiegelung.

Nach einem erfolgreichen Aufruf von SetWindowRgn besitzt das System die Region, die vom Regionshandle hRgn angegeben wird. Das System macht keine Kopie der Region. Daher sollten Sie keine weiteren Funktionsaufrufe mit diesem Regionshandle ausführen. Löschen Sie insbesondere dieses Regionshandle nicht. Das System löscht das Regionshandle, wenn es nicht mehr benötigt wird.

Um den Fensterbereich eines Fensters abzurufen, rufen Sie die GetWindowRgn-Funktion auf.

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-0 (eingeführt in Windows 8)