This documentation is archived and is not being maintained.

Rect.Inflate Method (Size)

Updated: February 2009

Expands the rectangle by using the specified Size, in all directions.

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

public void Inflate(
	Size size
)
You cannot use methods in XAML.

Parameters

size
Type: System.Windows.Size

Specifies the amount to expand the rectangle. The Size structure's Width property specifies the amount to increase the rectangle's Left and Right properties. The Size structure's Height property specifies the amount to increase the rectangle's Top and Bottom properties.

ExceptionCondition
InvalidOperationException

This method is called on the Rect.Empty rectangle.

The Width of the resulting rectangle is increased by twice the Width of the specified Size structure, because both the left and right sides of the rectangle are inflated. Likewise, the Height of the resulting rectangle is increased by twice the Height of the specified Size structure.

The following example shows how to use the Inflate(Size) method to increase the size of a rectangle.

private Size inflateExample1()
{
    // 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);

    // Use the Inflate method to expand the rectangle by the specified Size in all 
    // directions. The new size is 240,110. Note: Width of the resulting rectangle   
    // is increased by twice the Width of the specified Size structure because   
    // both the left and right sides of the rectangle are inflated. Likewise, the  
    // Height of the resulting rectangle is increased by twice the Height of the  
    // specified Size structure.
    myRectangle.Inflate(new Size(20,30));

    return myRectangle.Size;

}

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

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

.NET Framework

Supported in: 3.5, 3.0

Date

History

Reason

February 2009

Added Exceptions section.

Customer feedback.

Show: