AutoSize Property Overview
The AutoSize property enables a control to change its size, if necessary, to attain the value specified by the PreferredSize property. You adjust the sizing behavior for specific controls by setting the AutoSizeMode property.
AutoSize Behavior
Only some controls support the AutoSize property. In addition, some controls that support the AutoSize property also support the AutoSizeMode property.
The AutoSize property produces somewhat different behavior, depending on the specific control type and the value of the AutoSizeMode property, if the property exists. The following table describes the behaviors that are always true and provides a brief description of each:
| Always true behavior | Description |
|---|---|
Automatic sizing is a run-time feature. |
This means it never grows or shrinks a control and then has no further effect. |
If a control changes size, the value of its Location property always remains constant. |
When a control's contents cause it to grow, the control grows toward the right and downward. Controls do not grow to the left. |
The Dock and Anchor properties are honored when AutoSize is true. |
The value of the control's Location property is adjusted to the correct value. Note The Label control is the exception to this rule. When you set the value of a docked Label control's AutoSize property to true, the Label control will not stretch. |
A control's MaximumSize and MinimumSize properties are always honored, regardless of the value of its AutoSize property. |
The MaximumSize and MinimumSize properties are not affected by the AutoSize property. |
There is no minimum size set by default. |
This means that if a control is set to shrink under AutoSize and it has no contents, the value of its Size property is 0,0. In this case, your control will shrink to a point, and it will not be readily visible. |
If a control does not implement the GetPreferredSize method, the GetPreferredSize method returns last value assigned to the Size property. |
This means that setting AutoSize to true will have no effect. |
A control in a TableLayoutPanel cell always shrinks to fit in the cell until its MinimumSize is reached. |
This size is enforced as a maximum size. This is not the case when the cell is part of an AutoSize row or column. |
AutoSizeMode Property
The AutoSizeMode property provides more fine-grained control over the default AutoSize behavior. The AutoSizeMode property specifies how a control sizes itself to its content. The content, for example, could be the text for a Button control or the child controls for a container.
The following table shows the AutoSizeMode settings and a description of the behavior each setting elicits.
| AutoSizeMode setting | Behavior |
|---|---|
GrowAndShrink |
The control grows or shrinks to encompass its contents. The MinimumSize and MaximumSize values are honored, but the current value of the Size property is ignored. This is the same behavior as controls with the AutoSize property and no AutoSizeMode property. |
GrowOnly |
The control grows as much as necessary to encompass its contents, but it will not shrink smaller than the value specified by its Size property. This is the default value for AutoSizeMode. |
Controls That Support the AutoSize Property
The following table lists the controls that support the AutoSize and AutoSizeMode properties.
| AutoSize support | Control type |
|---|---|
|
Label MaskedTextBox (TextBox base) TextBox |
|
Button TableLayoutPanel |
|
CheckedListBox MaskedTextBox |
AutoSize in the Design Environment
The following table describes the sizing behavior of a control at design time, based on the value of its AutoSize and AutoSizeMode properties.
Override the SelectionRules property to determine whether a given control is in a user-resizable state. In the following table, "cannot" means Moveable only, "can" means AllSizeable and Moveable.
| AutoSize settings | Design-time sizing gesture |
|---|---|
|
The user cannot resize the control at design time, except for the following controls:
|
|
The user cannot resize the control at design time. |
|
The user can resize the control at design time. When the Size property is set, the user can only increase the size of the control. |
|
User can resize the control at design time. |
.gif) Note |
|---|
To maximize productivity, the Windows Forms Designer shadows the AutoSize property for the Form class. At design time, the form behaves as though the AutoSize property is set to false, regardless of its actual setting. At runtime, no special accommodation is made, and the AutoSize property is applied as specified by the property setting. |