DataGridViewAutoSizeColumnsMode Énumération

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Définit des valeurs pour spécifier comment les largeurs de colonnes sont ajustées.

public enum class DataGridViewAutoSizeColumnsMode

public enum DataGridViewAutoSizeColumnsMode

type DataGridViewAutoSizeColumnsMode =

Public Enum DataGridViewAutoSizeColumnsMode

Héritage: Object

ValueType

Enum
DataGridViewAutoSizeColumnsMode

Champs

AllCells	6	Les largeurs de colonne s'ajustent pour correspondre au contenu de toutes les cellules des colonnes, y compris les cellules d'en-tête.
AllCellsExceptHeader	4	Les largeurs de colonne s'ajustent pour correspondre au contenu de toutes les cellules des colonnes, sauf les cellules d'en-tête.
ColumnHeader	2	Les largeurs de colonne s'ajustent pour correspondre au contenu des cellules de l'en-tête de colonne.
DisplayedCells	10	Les largeurs de colonne s'ajustent pour correspondre au contenu de toutes les cellules des colonnes qui sont dans les lignes affichées à l'écran actuellement, y compris les cellules d'en-tête.
DisplayedCellsExceptHeader	8	Les largeurs de colonne s'ajustent pour correspondre au contenu de toutes les cellules des colonnes qui sont dans les lignes affichées à l'écran actuellement, sauf les cellules d'en-tête.
Fill	16	Les largeurs de colonne s'ajustent afin que les largeurs de toutes les colonnes remplissent exactement la zone d'affichage du contrôle, nécessitant uniquement un défilement horizontal pour conserver des largeurs de colonne au-dessus des valeurs de propriété MinimumWidth. Les largeurs de colonne relatives sont déterminées par les valeurs de propriété FillWeight relatives.
None	1	Les largeurs de colonne ne s'ajustent pas automatiquement.

Exemples

L’exemple de code suivant illustre l’utilisation de cette énumération dans un scénario maître/détails 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 des colonnes pour le contrôle maître n’est aucun 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 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

Le DataGridView contrôle peut redimensionner ses colonnes pour les rendre remplies de la largeur horizontale disponible du contrôle ou pour les rendre afficher le contenu complet de toutes les cellules ou de cellules spécifiées.

Avec Fill le mode, la largeur préférée d’une colonne est déterminée en redimensionnant toutes les colonnes de ce mode afin que toutes les colonnes visibles du contrôle remplissent exactement la largeur horizontale de la zone d’affichage disponible. Avec d’autres modes, la largeur de colonne préférée est la largeur minimale requise pour afficher la plus grande valeur de cellule à partir de toutes les cellules ou d’un sous-ensemble de cellules de cette colonne, comme le sous-ensemble de cellules actuellement affichées. L’utilisation d’un sous-ensemble de cellules pour déterminer la nouvelle largeur est utile pour éviter une pénalité de performances lors de l’utilisation de nombreuses lignes de données.

Le redimensionnement automatique basé sur le contenu empêche les utilisateurs d’ajuster les largeurs de colonne avec la souris. Toutefois, le redimensionnement de l’utilisateur est activé en mode de remplissage.

Cette énumération est utilisée par la propriété et AutoResizeColumns la DataGridView méthode de contrôleAutoSizeColumnsMode.

Pour plus d’informations sur les modes de dimensionnement, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms. Pour plus d’informations sur le mode de remplissage de colonne en particulier, consultez le mode remplissage de colonne dans le contrôle DataGridView Windows Forms.

S’applique à