SetRectEmpty function (winuser.h)

The SetRectEmpty function creates an empty rectangle in which all coordinates are set to zero.

Syntax

BOOL SetRectEmpty(
  [out] LPRECT lprc
);

Parameters

[out] lprc

Pointer to the RECT structure that contains the coordinates of the rectangle.

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

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

See also

CopyRect

RECT

Rectangle Functions

Rectangles Overview

SetRect