This documentation is archived and is not being maintained.

Rect.Inflate Method (Double, Double)

Updated: February 2009

Expands or shrinks the rectangle by using the specified width and height amounts, in all directions.

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

public void Inflate(
	double width,
	double height
)
You cannot use methods in XAML.

Parameters

width
Type: System.Double

The amount by which to expand or shrink the left and right sides of the rectangle.

height
Type: System.Double

The amount by which to expand or shrink the top and bottom sides of the rectangle.

ExceptionCondition
InvalidOperationException

This method is called on the Rect.Empty rectangle.

The Width of the resulting rectangle is increased or decreased by twice the specified width offset, because it is applied to both the left and right sides of the rectangle. Likewise, the Height of the resulting rectangle is increased or decreased by twice the specified height.

If the specified width or height shrink the rectangle by more than its current Width or Height—giving the rectangle a negative area—the rectangle becomes the Empty rectangle.

The following example shows how to use the Inflate(Double, Double) method to change the size of a rectangle.

private Size inflateExample2()
{
    // 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 or shrink the rectangle by the specified  
    // width and height amounts. The new size is 160,150 (width shrunk by 40 and   
    // height increased by 100). Note: Width of the resulting rectangle is increased  
    // or shrunk by twice the specified width, because both the left and right sides   
    // of the rectangle are inflated or shrunk. Likewise, the height of the resulting  
    // rectangle is increased or shrunk by twice the specified height.
    myRectangle.Inflate(-20,50);

    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: