DataGridView.AutoSizeColumnsMode Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtient ou définit une valeur indiquant comment les largeurs de colonne sont déterminées.

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é

DataGridViewAutoSizeColumnsMode

Valeur DataGridViewAutoSizeColumnsMode. La valeur par défaut est None.

Exceptions

InvalidEnumArgumentException

La valeur spécifiée au moment de la définition de cette propriété n’est pas une valeur DataGridViewAutoSizeColumnsMode valide.

InvalidOperationException

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.

  • ou - 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.

Exemples

L’exemple de code suivant montre comment utiliser cette propriété dans un scénario maître/détail où deux contrôles affichent des données à partir de deux DataGridView tables dans une relation parent/enfant. 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 ajuster les valeurs chargées. Le contrôle de détails est défini sur un mode de dimensionnement automatique de colonnes 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). Cet exemple fait partie d’un exemple plus large disponible dans 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 automatiquement ajustées pour remplir le contrôle ou pour ajuster le contenu de la cellule. Les ajustements de taille se produisent en mode remplissage chaque fois que la largeur du contrôle change. 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, s’il WrapMode est activé, chaque fois que les hauteurs de ligne changent. Certains modes de dimensionnement basés sur le contenu vous permettent de limiter l’ajustement de taille aux lignes actuellement affichées afin d’augmenter les performances.

Pour modifier le mode de dimensionnement d’une colonne individuelle, définissez sa AutoSizeMode propriété. La valeur par défaut de cette propriété est NotSet, indiquant que la colonne hérite de son comportement et de sa InheritedAutoSizeMode valeur de propriété du contrôle.

Les colonnes en mode remplissage divisent la largeur de contrôle disponible en proportions indiquées par leurs FillWeight valeurs de propriété. 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. Si cette largeur est inférieure aux valeurs combinées MinimumWidth de toutes les colonnes en mode remplissage, la barre de défilement horizontale s’affiche, toutes les colonnes en mode remplissage sont affichées avec leurs largeurs minimales et le redimensionnement des colonnes utilisateur est désactivé. Pour plus d’informations sur le mode de remplissage de colonne, consultez Le mode Remplissage de colonne dans le Windows Forms Contrôle DataGridView.

Seules les colonnes dont la Visible valeur de propriété est true redimensionnée sont redimensionnées automatiquement et la modification de la visibilité d’une colonne ne provoque pas le redimensionnement. En outre, lorsque les colonnes sont définies pour redimensionner automatiquement, l’utilisateur ne peut pas ajuster les largeurs de colonne avec la souris.

Pour ajuster les largeurs de colonne par programmation, utilisez les AutoResizeColumn méthodes ou AutoResizeColumns définissez la propriété de colonne Width .

Pour plus d’informations sur le dimensionnement automatique basé sur le contenu, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms.

S’applique à

Voir aussi