Form.AutoSizeMode Property

 
System_CAPS_noteNote

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

Gets or sets the mode by which the form automatically resizes itself.

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

[<BrowsableAttribute(true)>]
member AutoSizeMode : AutoSizeMode with get, set

Property Value

Type: System.Windows.Forms.AutoSizeMode

An AutoSizeMode enumerated value. The default is GrowOnly.

Exception Condition
InvalidEnumArgumentException

The value is not a valid AutoSizeMode value.

Setting the AutoSizeMode property to a new value causes the form to be laid out again.

A form does not automatically resize in the Visual Studio forms designer, regardless of the values of the AutoSize and AutoSizeMode properties. The form correctly resizes itself at run time according to the values of these two properties. By contrast, a custom UserControl automatically resizes itself both at design time and at run time.

The following code example shows a form created using code that automatically resizes to fit its contents. When run, the form displaya a Label, a TextBox for entering a URL, and a Button for displaying that URL inside of the user's default Web browser. The code example uses a FlowLayoutPanel to lay out the contained controls one after the other. It also sets the AutoSize and AutoSizeMode to grow and shrink to fit the contents of its form.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: