EqualRect function (winuser.h)

Article
10/13/2021

The EqualRect function determines whether the two specified rectangles are equal by comparing the coordinates of their upper-left and lower-right corners.

Syntax

BOOL EqualRect(
  [in] const RECT *lprc1,
  [in] const RECT *lprc2
);

Parameters

[in] lprc1

Pointer to a RECT structure that contains the logical coordinates of the first rectangle.

[in] lprc2

Pointer to a RECT structure that contains the logical coordinates of the second rectangle.

Return value

If the two rectangles are identical, the return value is nonzero.

If the two rectangles are not identical, the return value is zero.

Remarks

The EqualRect function does not treat empty rectangles as equal if their coordinates are different.

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.

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