SetRectRgn function (wingdi.h)

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

Syntax

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

Parameters

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

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

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

Requirements

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

See also

CreateRectRgn

Region Functions

Regions Overview