Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.


Call this member function to get the window region of a window.

int GetWindowRgn( 
   HRGN hRgn  


A handle to a window region.

The return value specifies the type of the region that the function obtains. It can be one of the following values:

  • 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.

The window region determines the area within the window where the operating system permits drawing. The operating system does not display any portion of a window that lies outside of the window region.

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 CWnd::SetWindowRgn.

Header: afxwin.h

Community Additions

© 2015 Microsoft