SetRect function (winuser.h)

The SetRect function sets the coordinates of the specified rectangle. This is equivalent to assigning the left, top, right, and bottom arguments to the appropriate members of the RECT structure.

Syntax

BOOL SetRect(
  [out] LPRECT lprc,
  [in]  int    xLeft,
  [in]  int    yTop,
  [in]  int    xRight,
  [in]  int    yBottom
);

Parameters

[out] lprc

Pointer to the RECT structure that contains the rectangle to be set.

[in] xLeft

Specifies the x-coordinate of the rectangle's upper-left corner.

[in] yTop

Specifies the y-coordinate of the rectangle's upper-left corner.

[in] xRight

Specifies the x-coordinate of the rectangle's lower-right corner.

[in] yBottom

Specifies the y-coordinate of the rectangle's lower-right corner.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

Because applications can use rectangles for different purposes, the rectangle functions do not use an explicit unit of measure. Instead, all rectangle coordinates and dimensions are given in signed, logical values. The mapping mode and the function in which the rectangle is used determine the units of measure.

Examples

For an example, see Using Rectangles.

Requirements

See also

CopyRect

RECT

Rectangle Functions

Rectangles Overview

SetRectEmpty