UnionRect

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function creates the union of two rectangles. The union is the smallest rectangle that contains both source rectangles.

Syntax

BOOL UnionRect(
  LPRECT lprcDst, 
  const RECT* lprcSrc1, 
  const RECT* lprcSrc2
);

Parameters

  • lprcDst
    Long pointer to the RECT structure that will receive a rectangle containing the rectangles pointed to by the lprcSrc1 and lprcSrc2 parameters.
  • lprcSrc1
    Long pointer to the RECT structure that contains the first source rectangle.
  • lprcSrc2
    Long pointer to the RECT structure that contains the second source rectangle.

Return Value

Nonzero indicates that the specified structure contains a nonempty rectangle.

Zero indicates that the specified structure does not contain a nonempty rectangle.

To get extended error information, call GetLastError.

Remarks

The system ignores the dimensions of an empty rectangle; that is, a rectangle in which all coordinates are set to zero, so it has no height or no width.

Requirements

Header winuser.h
Library Rectapi.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

InflateRect
IntersectRect
OffsetRect
RECT