This documentation is archived and is not being maintained.


Call this member function to set a window's region.

int SetWindowRgn(
   HRGN hRgn,
   BOOL bRedraw 


A handle to a region.


If TRUE, the operating system redraws the window after setting the region; otherwise, it does not. Typically, set bRedraw to TRUE if the window is visible. If set to TRUE, the system sends the WM_WINDOWPOSCHANGING and WM_WINDOWPOSCHANGED messages to the window.

If the function succeeds, the return value is nonzero. If the function fails, the return value is zero.

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.

After a successful call to SetWindowRgn, the operating system owns the region specified by the region handle hRgn. The operating system does not make a copy of the region, so do not make any further function calls with this region handle, and do not close this region handle.

Header: afxwin.h