This topic has not yet been rated - Rate this topic

SetRectRgn function

Applies to: desktop apps only

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

Syntax

BOOL SetRectRgn(
  __in  HRGN hrgn,
  __in  int nLeftRect,
  __in  int nTopRect,
  __in  int nRightRect,
  __in  int nBottomRect
);

Parameters

hrgn [in]

Handle to the region.

nLeftRect [in]

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

nTopRect [in]

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

nRightRect [in]

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

nBottomRect [in]

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

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Regions Overview
Region Functions
CreateRectRgn

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ