SetRectRgn function (wingdi.h)

The SetRectRgn function converts a region into a rectangular region with the specified coordinates.

Syntax

C++

BOOL SetRectRgn(
  [in] HRGN hrgn,
  [in] int  left,
  [in] int  top,
  [in] int  right,
  [in] int  bottom
);

[in] hrgn

Handle to the region.

[in] left

Specifies the x-coordinate of the upper-left corner of the rectangular region in logical units.

[in] top

Specifies the y-coordinate of the upper-left corner of the rectangular region in logical units.

[in] right

Specifies the x-coordinate of the lower-right corner of the rectangular region in logical units.

[in] bottom

Specifies the y-coordinate of the lower-right corner of the rectangular region in logical units.

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

The region does not include the lower and right boundaries of the rectangle.

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	wingdi.h (include Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll