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