Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DataGridViewAutoSizeColumnsMode énumération

 

Date de publication : novembre 2016

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

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

public enum DataGridViewAutoSizeColumnsMode

Nom du membreDescription
AllCells

Les largeurs de colonne ajustent au contenu de toutes les cellules dans les colonnes, y compris les cellules d’en-tête.

AllCellsExceptHeader

Les largeurs de colonne ajustent au contenu de toutes les cellules dans les colonnes, sauf les cellules d’en-tête.

ColumnHeader

Les largeurs de colonne ajustent au contenu des cellules d’en-tête de colonne.

DisplayedCells

Les largeurs de colonne ajustent au contenu de toutes les cellules dans les colonnes qui sont dans les lignes affichées à l’écran, y compris les cellules d’en-tête.

DisplayedCellsExceptHeader

Les largeurs de colonne ajustent au contenu de toutes les cellules dans les colonnes qui sont dans les lignes affichées à l’écran, à l’exception des cellules d’en-tête.

Fill

Les largeurs de colonne ajustent afin que les largeurs de toutes les colonnes remplissent exactement la zone d’affichage du contrôle, nécessitant un défilement horizontal pour conserver des largeurs de colonne au-dessus du DataGridViewColumn.MinimumWidth les valeurs de propriété. Des largeurs de colonne sont déterminés par le rapport DataGridViewColumn.FillWeight les valeurs de propriété.

None

Les largeurs de colonne ne s’ajustent pas automatiquement.

Le DataGridView contrôle peut redimensionner ses colonnes pour qu’elles remplissent la largeur horizontale disponible du contrôle ou qu’elles affichent le contenu complet de toutes les cellules ou des cellules spécifiées.

Avec Fill mode, la largeur par défaut d’une colonne est déterminé par le redimensionnement de toutes les colonnes dans ce mode afin que toutes les colonnes visibles dans le contrôle remplissent exactement la largeur horizontale de la zone d’affichage disponible. Avec les autres modes, la largeur de colonne par défaut est la largeur minimale requise pour afficher la plus grande valeur de cellule à partir de toutes les cellules ou un sous-ensemble de cellules dans la colonne, telles que le sous-ensemble de cellules dans les lignes actuellement affichées. À l’aide d’un sous-ensemble de cellules pour déterminer la nouvelle largeur est utile pour éviter une altération des performances lorsque vous travaillez avec plusieurs lignes de données.

Le redimensionnement automatique en fonction du contenu empêche les utilisateurs d’ajuster les largeurs de colonne avec la souris. Redimensionnement par l’utilisateur est activé en mode de remplissage, toutefois.

Cette énumération est utilisée par le DataGridView contrôle AutoSizeColumnsMode propriété et AutoResizeColumns (méthode).

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 la page Mode Remplissage des colonnes dans le contrôle DataGridView Windows Forms.

L’exemple de code suivant illustre l’utilisation de cette énumération dans un scénario maître/détails où deux DataGridView contrôles affichent des données provenant de deux tables dans une relation parent/enfant. Dans cet exemple, le mode de dimensionnement du contrôle maître est None et les largeurs de colonne sont initialisées par programme pour correspondre aux valeurs chargées. Le contrôle de détails est défini sur un mode de dimensionnement automatique afin que les colonnes seront 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 développé disponible dans Comment : créer un formulaire maître/détail utilisant deux contrôles DataGridView Windows Form.

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;
}

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: