DataGridView.AutoSizeColumnsMode Propriété

Définition

Obtient ou définit une valeur indiquant comment les largeurs de colonne sont déterminées.Gets or sets a value indicating how column widths are determined.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { System::Windows::Forms::DataGridViewAutoSizeColumnsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnsMode value); };
public System.Windows.Forms.DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }
member this.AutoSizeColumnsMode : System.Windows.Forms.DataGridViewAutoSizeColumnsMode with get, set
Public Property AutoSizeColumnsMode As DataGridViewAutoSizeColumnsMode

Valeur de propriété

Exceptions

La valeur spécifiée au moment de la définition de cette propriété n’est pas une valeur DataGridViewAutoSizeColumnsMode valide.The specified value when setting this property is not a valid DataGridViewAutoSizeColumnsMode value.

La valeur spécifiée au moment de la définition de cette propriété est ColumnHeader, les en-têtes de colonne sont masqués et au moins une colonne visible a une valeur de propriété AutoSizeMode égale à NotSet.The specified value when setting this property is ColumnHeader, column headers are hidden, and at least one visible column has an AutoSizeMode property value of NotSet.

- ou --or- La valeur spécifiée au moment de la définition de cette propriété est Fill et au moins une colonne visible dont une valeur de propriété AutoSizeMode est égale à NotSet est figée.The specified value when setting this property is Fill and at least one visible column with an AutoSizeMode property value of NotSet is frozen.

Exemples

L’exemple de code suivant illustre l’utilisation de cette propriété dans un scénario maître/détail où deux contrôles DataGridView affichent des données de deux tables dans une relation parent/enfant.The following code example illustrates how to use this property in a master/detail scenario where two DataGridView controls display data from two tables in a parent/child relationship. Dans cet exemple, le mode de dimensionnement de colonne pour le contrôle maître est None, et les largeurs de colonne sont initialisées par programmation pour s’ajuster aux valeurs chargées.In this example, the column sizing mode for the master control is None, and the column widths are programmatically initialized to fit the loaded values. Le contrôle des détails est défini sur un mode de redimensionnement de colonne automatique afin que les colonnes s’ajustent automatiquement chaque fois que les valeurs changent (par exemple, lorsque l’utilisateur modifie la ligne actuelle dans la table parente).The details control is set to an automatic column sizing mode so that columns will adjust automatically whenever the values change (for example, when the user changes the current row in the parent table). Cet exemple fait partie d’un exemple plus complet disponible dans How à : Créez un formulaire maître/détail à l’aide de deux Windows Forms contrôles DataGridView.This example is part of a larger example available in How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls.

private void Form1_Load(object sender, System.EventArgs e)
{
    // Bind the DataGridView controls to the BindingSource
    // components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource;
    detailsDataGridView.DataSource = detailsBindingSource;
    GetData();

    // Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns();

    // Configure the details DataGridView so that its columns automatically
    // adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = 
        DataGridViewAutoSizeColumnsMode.AllCells;
}
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Load

    ' Bind the DataGridView controls to the BindingSource
    ' components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource
    detailsDataGridView.DataSource = detailsBindingSource
    GetData()

    ' Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns()

    ' Configure the details DataGridView so that its columns automatically
    ' adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = _
        DataGridViewAutoSizeColumnsMode.AllCells

End Sub

Remarques

Cette propriété vous permet de configurer le contrôle afin que les largeurs de colonne soient ajustées automatiquement soit pour remplir le contrôle, soit pour ajuster le contenu des cellules.This property lets you configure the control so that column widths are automatically adjusted either to fill the control or to fit cell contents. Les ajustements de taille se produisent en mode de remplissage à chaque modification de la largeur du contrôle.Size adjustments occur in fill mode whenever the width of the control changes. Dans les modes de dimensionnement basés sur le contenu, les ajustements de taille se produisent chaque fois que le contenu de la cellule change ou, si WrapMode est activé, chaque fois que les hauteurs de lignes changent.In content-based sizing modes, size adjustments occur whenever cell contents change or, if WrapMode is enabled, whenever row heights change. Certains modes de dimensionnement basés sur le contenu vous permettent de limiter le réglage de taille aux lignes actuellement affichées afin d’améliorer les performances.Some content-based sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

Pour modifier le mode de dimensionnement d’une colonne individuelle, définissez sa propriété AutoSizeMode.To change the sizing mode for an individual column, set its AutoSizeMode property. La valeur par défaut de cette propriété est NotSet, ce qui indique que la colonne hérite son comportement et sa valeur de propriété InheritedAutoSizeMode du contrôle.The default value of this property is NotSet, indicating that the column inherits its behavior and its InheritedAutoSizeMode property value from the control.

Les colonnes en mode de remplissage divisent la largeur de contrôle disponible dans les proportions indiquées par leurs valeurs de propriété FillWeight.Columns in fill mode divide the available control width in proportions indicated by their FillWeight property values. La largeur disponible pour le mode de remplissage est déterminée en soustrayant les largeurs de toutes les autres colonnes de la largeur de la zone cliente du contrôle.The width available for fill mode is determined by subtracting the widths of all other columns from the width of the client area of the control. Si cette largeur est inférieure aux valeurs MinimumWidth combinées de toutes les colonnes en mode de remplissage, la barre de défilement horizontale est affichée, toutes les colonnes en mode de remplissage sont affichées avec leurs largeurs minimales et le redimensionnement des colonnes utilisateur est désactivé.If this width is smaller than the combined MinimumWidth values of all fill-mode columns, the horizontal scroll bar is displayed, all fill-mode columns are shown with their minimum widths, and user column-resizing is disabled. Pour plus d’informations sur le mode de remplissage de colonne, consultez mode de remplissage de colonne dans le contrôle DataGridView Windows Forms.For more information about column fill mode, see Column Fill Mode in the Windows Forms DataGridView Control.

Seules les colonnes dont la valeur de propriété Visible est égale à true sont redimensionnées automatiquement et la modification de la visibilité d’une colonne n’entraîne pas de redimensionnement.Only columns with a Visible property value of true are resized automatically, and changing the visibility of a column does not cause resizing to occur. En outre, lorsque les colonnes sont définies pour un redimensionnement automatique, l’utilisateur ne peut pas ajuster la largeur des colonnes avec la souris.Additionally, when columns are set to automatically resize, the user cannot adjust the column widths with the mouse.

Pour ajuster les largeurs de colonne par programme, utilisez les méthodes AutoResizeColumn ou AutoResizeColumns ou définissez la propriété Width.To adjust column widths programmatically, use the AutoResizeColumn or AutoResizeColumns methods or set the column Width property.

Pour plus d’informations sur le dimensionnement automatique basé sur le contenu, consultez options de dimensionnement dans le contrôle DataGridView Windows Forms.For more information about content-based automatic sizing, see Sizing Options in the Windows Forms DataGridView Control.

S’applique à

Voir aussi