Exporter (0) Imprimer
Développer tout
Développer Réduire

DataGridView.AutoSizeColumnsMode, propriété

Mise à jour : novembre 2007

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

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

public DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }
/** @property */
public DataGridViewAutoSizeColumnsMode get_AutoSizeColumnsMode()
/** @property */
public  void set_AutoSizeColumnsMode(DataGridViewAutoSizeColumnsMode value)

public function get AutoSizeColumnsMode () : DataGridViewAutoSizeColumnsMode
public function set AutoSizeColumnsMode (value : DataGridViewAutoSizeColumnsMode)

Valeur de propriété

Type : System.Windows.Forms.DataGridViewAutoSizeColumnsMode

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

ExceptionCondition
InvalidEnumArgumentException

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

InvalidOperationException

La valeur spécifiée lors de la définition de cette propriété est ColumnHeader, les en-têtes de colonnes sont masqués et une colonne visible au moins a une valeur de propriété AutoSizeMode de NotSet.

– ou –

La valeur spécifiée lors de la définition de cette propriété est Fill et au moins une colonne visible avec une valeur de propriété AutoSizeMode de NotSet est figée.

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 ajuster le contenu de cellule. Les réglages de taille se produisent en mode de remplissage à chaque fois que la largeur du contrôle est modifiée. Dans les modes de dimensionnement basés sur le contenu, les réglages de taille se produisent à chaque fois que le contenu de cellule change ou, si WrapMode est activé, à chaque fois que les hauteurs de ligne changent. Certains modes de dimensionnement basés sur le contenu vous permettent de limiter le réglage de taille aux lignes actuellement affichées pour augmenter les performances.

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

Les colonnes en mode de remplissage divisent la largeur du contrôle disponible dans des proportions indiquées par leurs valeurs de propriété FillWeight. La largeur disponible pour le mode de remplissage est déterminée par soustraction des largeurs de toutes les autres colonnes à la largeur de la zone cliente du contrôle. Si cette largeur est plus petite que les 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 par l'utilisateur est désactivé. Pour plus d'informations sur le mode de remplissage de colonne, consultez Mode Remplissage des colonnes dans le contrôle DataGridView Windows Forms.

Seules les colonnes avec une valeur de la propriété Visible égale à true sont redimensionnées automatiquement ; la modification de la visibilité d'une colonne ne provoque pas le redimensionnement. En outre, lorsque les colonnes sont configurées pour être automatiquement redimensionnées, l'utilisateur ne peut pas ajuster les largeurs de colonne avec la souris.

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

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

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 à partir de deux tables dans une relation de 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 a pour valeur un mode de dimensionnement 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). Cet exemple de code fait partie d'un exemple plus complet 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;
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft