DataGridViewColumn.AutoSizeMode Propriété

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.

Obtient ou définit le mode qui permet à la colonne de modifier automatiquement sa largeur.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnMode AutoSizeMode { System::Windows::Forms::DataGridViewAutoSizeColumnMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnMode value); };

public System.Windows.Forms.DataGridViewAutoSizeColumnMode AutoSizeMode { get; set; }

member this.AutoSizeMode : System.Windows.Forms.DataGridViewAutoSizeColumnMode with get, set

Public Property AutoSizeMode As DataGridViewAutoSizeColumnMode

Valeur de propriété

DataGridViewAutoSizeColumnMode

Valeur DataGridViewAutoSizeColumnMode qui détermine si la colonne modifie automatiquement sa largeur et comment elle définit sa largeur par défaut. La valeur par défaut est NotSet.

Exceptions

InvalidEnumArgumentException

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

InvalidOperationException

La valeur spécifiée lors de la définition de cette propriété indique une valeur InheritedAutoSizeMode de ColumnHeader pour une colonne visible lorsque les en-têtes de colonne sont masqués.

ou - La valeur spécifiée lors de la définition de cette propriété indique une valeur InheritedAutoSizeMode de Fill pour une colonne visible figée.

Exemples

L’exemple de code suivant force une colonne à redimensionner automatiquement sa largeur en fonction de son contenu. Cet exemple de code fait partie d’un exemple plus grand fourni pour la DataGridViewColumn classe.

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}

// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}

' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

Remarques

Le comportement de dimensionnement automatique de la colonne est déterminé par la valeur de la InheritedAutoSizeMode propriété, qui est la même que la valeur de la AutoSizeMode propriété pour toutes les valeurs, sauf NotSet, ce qui indique que la valeur est héritée de la propriété à la DataGridView.AutoSizeColumnsMode place.

Lorsque la valeur de la InheritedAutoSizeMode propriété est Fill, la colonne est redimensionnée avec d’autres colonnes dans ce mode. Toutes les colonnes en mode de remplissage du contrôle divisent l’espace disponible en proportions déterminé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 des colonnes, consultez le mode remplissage de colonne dans le contrôle DataGridView Windows Forms.

Lorsque la InheritedAutoSizeMode propriété est définie sur une autre valeur, sauf Noneque la colonne gère sa largeur afin que ses valeurs de cellule soient entièrement affichées sans découpage. Dans les modes de dimensionnement basés sur le contenu, les ajustements de taille se produisent chaque fois que le contenu des cellules 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 la taille aux lignes actuellement affichées afin d’augmenter les performances.

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

Pour ajuster les largeurs de colonne par programmation, utilisez les méthodes ou AutoResizeColumns les méthodes du DataGridView AutoResizeColumn contrôle ou définissez la propriété de colonneWidth.

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 à