Rect.Union Method (Rect, Rect)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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
Available since 3.0
Return to top