This function obtains a copy of the window region of a window. The window region of a window is set by calling the SetWindowRgn function. The window region determines the area within the window where the system permits drawing. The system does not display any portion of a window that lies outside of the window region.
int GetWindowRgn(HWND hWnd, HRGN hRgn);
Parameters
- hWnd
Handle to the window whose window region is to be obtained. - hRgn
Receives a handle to the window region.
Return Values
The return value specifies the type of the region that the function obtains. The following table shows some of the possible return values.
| Value | Description |
|---|---|
| NULLREGION | The region is empty. |
| SIMPLEREGION | The region is a single rectangle. |
| COMPLEXREGION | The region is more than one rectangle. |
| ERROR | An error occurred; the region is unaffected. |
Remarks
The coordinates of a window's window region are relative to the upper left corner of the window, not the client area of the window.
To set the window region of a window, call the SetWindowRgn function.
Requirements
OS Versions: Windows CE 2.12 and later.
Header: Winuser.h.
Link Library: Coredll.lib, Winmgr.lib.
See Also
Send Feedback on this topic to the authors