CreateRectRgn

The CreateRectRgn function creates a rectangular region.

HRGN CreateRectRgn(
  int nLeftRect,   // x-coordinate of region's upper-left corner
  int nTopRect,    // y-coordinate of region's upper-left corner
  int nRightRect,  // x-coordinate of region's lower-right corner
  int nBottomRect  // y-coordinate of region's lower-right corner
);
 

Parameters

nLeftRect

Specifies the x-coordinate of the upper-left corner of the region.

nTopRect

Specifies the y-coordinate of the upper-left corner of the region.

nRightRect

Specifies the x-coordinate of the lower-right corner of the region.

nBottomRect

Specifies the y-coordinate of the lower-right corner of the region.

Return Values

If the function succeeds, the return value is the handle to the region.

If the function fails, the return value is NULL.

Windows NT: To get extended error information, call GetLastError.

Remarks

The region will be exclusive of the bottom and right edges.

Windows CE: Windows CE represents regions using 16-bit values.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Requires version 2.0 or later.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.

See Also

Regions Overview, Region Functions, CreateRectRgnIndirect, CreateRoundRectRgn, DeleteObject, SelectObject