Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Form::AutoSize Property

 

Resize the form according to the setting of AutoSizeMode.

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

public:
[BrowsableAttribute(true)]
property bool AutoSize {
	virtual bool get() override;
	virtual void set(bool value) override;
}

Property Value

Type: System::Boolean

true if the form will automatically resize; false if it must be manually resized.

Use AutoSize to force a form to resize to fit its contents.

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.

When using AutoSize, the MinimumSize and MaximumSize properties are respected, but the current value of the Size property is ignored. Using AutoSize and AutoSizeMode also renders the AutoScroll property superfluous, as there is no way to shrink the form to hide its contained controls from view.

See the AutoSizeMode enumeration for information on how a form behaves when AutoSize is true.

The following code example shows a form created using code that automatically resizes to fit its contents. When run, the form displays 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: