Vue d'ensemble de la propriété AutoSizeAutoSize Property Overview

Le AutoSize propriété permet à un contrôle modifier sa taille, si nécessaire, pour atteindre la valeur spécifiée par le PreferredSize propriété.The AutoSize property enables a control to change its size, if necessary, to attain the value specified by the PreferredSize property. Vous ajustez le comportement de dimensionnement de contrôles spécifiques en définissant le AutoSizeMode propriété.You adjust the sizing behavior for specific controls by setting the AutoSizeMode property.

Comportement du redimensionnement automatiqueAutoSize Behavior

Seuls certains contrôles prennent en charge le AutoSize propriété.Only some controls support the AutoSize property. En outre, certains contrôles qui prennent en charge la AutoSize propriété prennent également en charge le AutoSizeMode propriété.In addition, some controls that support the AutoSize property also support the AutoSizeMode property.

Le AutoSize propriété produit un comportement quelque peu différent, selon le type de contrôle spécifique et la valeur de la AutoSizeMode propriété, si la propriété existe.The AutoSize property produces somewhat different behavior, depending on the specific control type and the value of the AutoSizeMode property, if the property exists. Le tableau suivant décrit les comportements qui sont toujours remplies et fournit une brève description de chacun d’eux :The following table describes the behaviors that are always true and provides a brief description of each:

Comportement toujours vraiAlways true behavior DescriptionDescription
Dimensionnement automatique est une fonctionnalité de l’exécution.Automatic sizing is a run-time feature. Cela signifie qu’il jamais augmente ou réduit un contrôle puis n’a aucun effet.This means it never grows or shrinks a control and then has no further effect.
Si un contrôle change de taille, la valeur de son Location propriété reste toujours constante.If a control changes size, the value of its Location property always remains constant. Lorsque le contenu d’un contrôle de le rendre de croître, le contrôle s’agrandit vers la droite et vers le bas.When a control's contents cause it to grow, the control grows toward the right and downward. Contrôles n’augmentent pas à gauche.Controls do not grow to the left.
Le Dock et Anchor propriétés sont respectées lorsque AutoSize est true.The Dock and Anchor properties are honored when AutoSize is true. La valeur du contrôle Location propriété est ajustée à la valeur correcte.The value of the control's Location property is adjusted to the correct value.

Remarque le Label contrôle fait exception à cette règle.Note The Label control is the exception to this rule. Lorsque vous définissez la valeur d’une fenêtre fixe Label du contrôle AutoSize propriété true, le Label contrôle s’étirera pas.When you set the value of a docked Label control's AutoSize property to true, the Label control will not stretch.
D’un contrôle MaximumSize et MinimumSize propriétés sont toujours respectées, quelle que soit la valeur de son AutoSize propriété.A control's MaximumSize and MinimumSize properties are always honored, regardless of the value of its AutoSize property. Le MaximumSize et MinimumSize propriétés ne sont pas affectées par la AutoSize propriété.The MaximumSize and MinimumSize properties are not affected by the AutoSize property.
Il n’existe aucune taille minimale définie par défaut.There is no minimum size set by default. Cela signifie que si un contrôle est configuré pour être réduit sous AutoSize et il n’a pas de contenu, la valeur de son Size propriété est 0,0.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. Dans ce cas, votre contrôle sera réduit à un point, et il ne sera pas facilement visible.In this case, your control will shrink to a point, and it will not be readily visible.
Si un contrôle n’implémente pas le GetPreferredSize (méthode), le GetPreferredSize méthode retourne la dernière valeur assignée à la Size propriété.If a control does not implement the GetPreferredSize method, the GetPreferredSize method returns last value assigned to the Size property. Cela signifie que la configuration AutoSize à true n’a aucun effet.This means that setting AutoSize to true will have no effect.
Un contrôle dans un TableLayoutPanel cellule toujours se réduit en fonction de la cellule jusqu'à ce que son MinimumSize est atteinte.A control in a TableLayoutPanel cell always shrinks to fit in the cell until its MinimumSize is reached. Cette taille est appliquée comme une taille maximale.This size is enforced as a maximum size. Cela n’est pas le cas lorsque la cellule fait partie d’un AutoSize ligne ou colonne.This is not the case when the cell is part of an AutoSize row or column.

AutoSizeMode (propriété)AutoSizeMode Property

Le AutoSizeMode propriété fournit un contrôle plus précis sur la valeur par défaut AutoSize comportement.The AutoSizeMode property provides more fine-grained control over the default AutoSize behavior. Le AutoSizeMode propriété spécifie comment un contrôle lui-même redimensionnée en fonction de son contenu.The AutoSizeMode property specifies how a control sizes itself to its content. Le contenu, par exemple, pourrait être le texte pour un Button contrôle ou les contrôles enfants pour un conteneur.The content, for example, could be the text for a Button control or the child controls for a container.

Le tableau suivant présente le AutoSizeMode paramètres et une description du comportement de chaque paramètre est fournie.The following table shows the AutoSizeMode settings and a description of the behavior each setting elicits.

Paramètre AutoSizeModeAutoSizeMode setting ComportementBehavior
GrowAndShrinkGrowAndShrink Le contrôle augmente ou réduit pour englober son contenu.The control grows or shrinks to encompass its contents.

Le MinimumSize et MaximumSize valeurs sont respectées, mais la valeur actuelle de la Size propriété est ignorée.The MinimumSize and MaximumSize values are honored, but the current value of the Size property is ignored.

Ceci est le même comportement que les contrôles avec le AutoSize propriété et aucune AutoSizeMode propriété.This is the same behavior as controls with the AutoSize property and no AutoSizeMode property.
GrowOnlyGrowOnly Le contrôle s’agrandit autant que nécessaire pour englober son contenu, mais il sera diminuer en dessous de la valeur spécifiée par son Size propriété.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.

Il s'agit de la valeur par défaut de l'objet AutoSizeMode.This is the default value for AutoSizeMode.

Contrôles qui prennent en charge la propriété AutoSizeControls That Support the AutoSize Property

Le tableau suivant répertorie les contrôles qui prennent en charge la AutoSize et AutoSizeMode propriétés.The following table lists the controls that support the AutoSize and AutoSizeMode properties.

Prise en charge AutoSizeAutoSize support Type de contrôleControl type
- AutoSize propriété prise en charge.- AutoSize property supported.
-Ne AutoSizeMode propriété.- No AutoSizeMode property.
CheckBox

DomainUpDown

Label

LinkLabel

MaskedTextBox (TextBox base)MaskedTextBox (TextBox base)

NumericUpDown

RadioButton

TextBox

TrackBar
- AutoSize propriété prise en charge.- AutoSize property supported.
- AutoSizeMode propriété prise en charge.- AutoSizeMode property supported.
Button

CheckedListBox

FlowLayoutPanel

Form

GroupBox

Panel

TableLayoutPanel
-Ne AutoSize propriété.- No AutoSize property. CheckedListBox

ComboBox

DataGridView

DateTimePicker

ListBox

ListView

MaskedTextBox

MonthCalendar

ProgressBar

PropertyGrid

RichTextBox

SplitContainer

TabControl

TabPage

TreeView

WebBrowser

ScrollBar

Redimensionnement automatique dans l’environnement de conceptionAutoSize in the Design Environment

Le tableau suivant décrit le comportement de dimensionnement d’un contrôle au moment du design, selon la valeur de son AutoSize et AutoSizeMode propriétés.The following table describes the sizing behavior of a control at design time, based on the value of its AutoSize and AutoSizeMode properties.

Remplacer le SelectionRules propriété afin de déterminer si un contrôle donné est dans un état redimensionnable pour l’utilisateur.Override the SelectionRules property to determine whether a given control is in a user-resizable state. Dans le tableau suivant, « ne peut pas » signifie Moveable uniquement, « peut » signifie AllSizeable et Moveable.In the following table, "cannot" means Moveable only, "can" means AllSizeable and Moveable.

Paramètres AutoSizeAutoSize settings Opération de dimensionnement d’au moment du designDesign-time sizing gesture
- AutoSize = true
-Ne AutoSizeMode propriété.- No AutoSizeMode property.
L’utilisateur ne peut pas redimensionner le contrôle au moment du design, sauf pour les contrôles suivants :The user cannot resize the control at design time, except for the following controls:

- TextBox
- MaskedTextBox
- RichTextBox
- TrackBar
- AutoSize = true
- AutoSizeMode = GrowAndShrink
L’utilisateur ne peut pas redimensionner le contrôle au moment du design.The user cannot resize the control at design time.
- AutoSize = true
- AutoSizeMode = GrowOnly
L’utilisateur peut redimensionner le contrôle au moment du design.The user can resize the control at design time. Lorsque le Size est définie, l’utilisateur peut uniquement augmenter la taille du contrôle.When the Size property is set, the user can only increase the size of the control.
- AutoSize = false, ou AutoSize propriété est masquée.- AutoSize = false, or AutoSize property is hidden. Utilisateur peut redimensionner le contrôle au moment du design.User can resize the control at design time.

Notes

Pour optimiser la productivité, le Concepteur de formulaires Windows dans Visual Studio shadows le AutoSize propriété pour la Form classe.To maximize productivity, the Windows Forms Designer in Visual Studio shadows the AutoSize property for the Form class. Au moment du design, le formulaire se comporte comme si le AutoSize propriété est définie sur false, quelle que soit sa valeur réelle.At design time, the form behaves as though the AutoSize property is set to false, regardless of its actual setting. Lors de l’exécution, aucun aménagement spécial n’est effectuée et le AutoSize propriété est appliquée comme spécifié par le paramètre de propriété.At runtime, no special accommodation is made, and the AutoSize property is applied as specified by the property setting.

Voir aussiSee also