This documentation is archived and is not being maintained.

Rect.Union Method (Rect, Rect)

Creates a rectangle that is exactly large enough to contain the two specified rectangles.

Namespace:  System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)

public static Rect Union(
	Rect rect1,
	Rect rect2


Type: System.Windows.Rect
The first rectangle to include.
Type: System.Windows.Rect
The second rectangle to include.

Return Value

Type: System.Windows.Rect
The resulting rectangle.

The following example shows how to use the Union(Rect, Rect) method to create a rectangle that is exactly large enough to contain two given rectangles.

private Rect unionExample4()
    // Initialize new rectangle.
    Rect myRectangle = new Rect();

    // The Location property specifies the coordinates of the upper left-hand 
    // corner of the rectangle. 
    myRectangle.Location = new Point(10, 5);

    // Set the Size property of the rectangle with a width of 200
    // and a height of 50.
    myRectangle.Size = new Size(200, 50);

    // Create second rectangle.
    Rect myRectangle2 = new Rect();
    myRectangle2.Location = new Point(0, 0);
    myRectangle2.Size = new Size(200, 50);

    // Create a third rectangle.
    Rect myRectangle3 = new Rect();
    myRectangle3.Location = new Point(210, 60);
    myRectangle3.Size = new Size(50, 50);

    // The Union method expands the current rectangle exactly enough to contain 
    // the two specified rectangles. In this example, returnRect expands to 
    // a location of 0,0 and a size of 260,110.
    Rect returnRect = Rect.Union(myRectangle2, myRectangle3);

    // Returns 0,0,260,110
    return returnRect;


.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.