Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 RECTstructure that will receive a rectangle containing the rectangles pointed to by the lprcSrc1and lprcSrc2parameters.

lprcSrc1

Long pointer to the RECTstructure that contains the first source rectangle.

lprcSrc2

Long pointer to the RECTstructure 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