DataGridView.AutoResizeColumn Méthode

  • Référence

Définition

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

Ajuste la largeur de la colonne spécifiée pour correspondre au contenu de ses cellules.

Surcharges

AutoResizeColumn(Int32)

Ajuste la largeur de la colonne spécifiée pour correspondre au contenu de toutes ses cellules, y compris la cellule d'en-tête.
AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode)

Ajuste la largeur de la colonne spécifiée à l'aide du mode de dimensionnement spécifié.
AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode, Boolean)

Ajuste la largeur de la colonne spécifiée à l'aide du mode de dimensionnement spécifié, en calculant éventuellement la largeur dans l'attente que les hauteurs de lignes soient ajustées par la suite.

AutoResizeColumn(Int32)

Ajuste la largeur de la colonne spécifiée pour correspondre au contenu de toutes ses cellules, y compris la cellule d'en-tête.

public:
 void AutoResizeColumn(int columnIndex);
public void AutoResizeColumn (int columnIndex);
member this.AutoResizeColumn : int -> unit
Public Sub AutoResizeColumn (columnIndex As Integer)

Paramètres

columnIndex
Int32

Index de la colonne à redimensionner.

Exceptions

ArgumentOutOfRangeException

columnIndex n’appartient pas à la plage valide, qui va de 0 au nombre de colonnes moins 1.

Exemples

L’exemple de code suivant utilise cette méthode pour rendre la largeur de colonne suffisamment grande pour prendre en charge une nouvelle valeur de cellule. Cet exemple fait partie d’un exemple plus large disponible dans How to: Manipulate Rows in the Windows Forms DataGridView Control.

// Give cheescake excellent rating.
void Button8_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   UpdateStars( dataGridView->Rows[ 4 ], L"******************" );
}

int ratingColumn;
void UpdateStars( DataGridViewRow^ row, String^ stars )
{
   row->Cells[ ratingColumn ]->Value = stars;
   
   // Resize the column width to account for the new value.
   row->DataGridView->AutoResizeColumn( ratingColumn, DataGridViewAutoSizeColumnMode::DisplayedCells );
}

// Give cheescake excellent rating.
private void Button8_Click(object sender,
    System.EventArgs e)
{
    UpdateStars(dataGridView.Rows[4], "******************");
}

int ratingColumn = 3;

private void UpdateStars(DataGridViewRow row, string stars)
{

    row.Cells[ratingColumn].Value = stars;

    // Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, 
        DataGridViewAutoSizeColumnMode.DisplayedCells);
}

' Give cheescake excellent rating.
Private Sub Button8_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    UpdateStars(dataGridView.Rows(4), "******************")
End Sub

Private ratingColumn As Integer = 3

Private Sub UpdateStars(ByVal row As DataGridViewRow, _
    ByVal stars As String)

    row.Cells(ratingColumn).Value = stars

    ' Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, _
        DataGridViewAutoSizeColumnMode.DisplayedCells)

End Sub

Remarques

Cette méthode est utile si vous souhaitez contrôler quand une colonne est redimensionnée. La largeur de colonne n’est ajustée qu’une seule fois par appel de méthode ; si le contenu de la colonne change ultérieurement, la colonne ne s’ajuste pas automatiquement. Pour redimensionner toutes les colonnes, utilisez la AutoResizeColumns méthode. Pour définir la colonne à redimensionner automatiquement chaque fois que son contenu change, utilisez la AutoSizeColumnsMode propriété ou la propriété de colonne AutoSizeMode .

Pour plus d’informations sur le redimensionnement par programmation, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms.

Voir aussi

S’applique à

AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode)

Ajuste la largeur de la colonne spécifiée à l'aide du mode de dimensionnement spécifié.

public:
 void AutoResizeColumn(int columnIndex, System::Windows::Forms::DataGridViewAutoSizeColumnMode autoSizeColumnMode);
public void AutoResizeColumn (int columnIndex, System.Windows.Forms.DataGridViewAutoSizeColumnMode autoSizeColumnMode);
member this.AutoResizeColumn : int * System.Windows.Forms.DataGridViewAutoSizeColumnMode -> unit
Public Sub AutoResizeColumn (columnIndex As Integer, autoSizeColumnMode As DataGridViewAutoSizeColumnMode)

Paramètres

columnIndex
Int32

Index de la colonne à redimensionner.

autoSizeColumnMode
DataGridViewAutoSizeColumnMode

Une des valeurs de l'objet DataGridViewAutoSizeColumnMode.

Exceptions

InvalidOperationException

autoSizeColumnMode a la valeur ColumnHeader et ColumnHeadersVisible a la valeur false.

ArgumentException

autoSizeColumnMode a la valeur NotSet, None ou Fill.

ArgumentOutOfRangeException

columnIndex n’appartient pas à la plage valide, qui va de 0 au nombre de colonnes moins 1.

InvalidEnumArgumentException

autoSizeColumnMode n’est pas une valeur de DataGridViewAutoSizeColumnMode valide.

Exemples

L’exemple de code suivant utilise cette méthode pour rendre la largeur de colonne suffisamment grande pour prendre en charge une nouvelle valeur de cellule. Cet exemple fait partie d’un exemple plus large disponible dans How to: Manipulate Rows in the Windows Forms DataGridView Control.

// Give cheescake excellent rating.
void Button8_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   UpdateStars( dataGridView->Rows[ 4 ], L"******************" );
}

int ratingColumn;
void UpdateStars( DataGridViewRow^ row, String^ stars )
{
   row->Cells[ ratingColumn ]->Value = stars;
   
   // Resize the column width to account for the new value.
   row->DataGridView->AutoResizeColumn( ratingColumn, DataGridViewAutoSizeColumnMode::DisplayedCells );
}

// Give cheescake excellent rating.
private void Button8_Click(object sender,
    System.EventArgs e)
{
    UpdateStars(dataGridView.Rows[4], "******************");
}

int ratingColumn = 3;

private void UpdateStars(DataGridViewRow row, string stars)
{

    row.Cells[ratingColumn].Value = stars;

    // Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, 
        DataGridViewAutoSizeColumnMode.DisplayedCells);
}

' Give cheescake excellent rating.
Private Sub Button8_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    UpdateStars(dataGridView.Rows(4), "******************")
End Sub

Private ratingColumn As Integer = 3

Private Sub UpdateStars(ByVal row As DataGridViewRow, _
    ByVal stars As String)

    row.Cells(ratingColumn).Value = stars

    ' Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, _
        DataGridViewAutoSizeColumnMode.DisplayedCells)

End Sub

Remarques

Cette méthode est utile si vous souhaitez contrôler quand une colonne est redimensionnée. La largeur de colonne n’est ajustée qu’une seule fois par appel de méthode ; si le contenu de la colonne change ultérieurement, la colonne ne s’ajuste pas automatiquement. Pour redimensionner toutes les colonnes, utilisez la AutoResizeColumns méthode. Pour définir la colonne à redimensionner automatiquement chaque fois que son contenu change, utilisez la AutoSizeColumnsMode propriété ou la propriété de colonne AutoSizeMode .

Cette surcharge vous permet de spécifier un mode de dimensionnement qui calcule la nouvelle largeur en fonction des valeurs d’un ensemble limité de cellules, comme celles des lignes affichées uniquement. Cela améliore les performances lorsque le contrôle contient un grand nombre de lignes.

Pour plus d’informations sur le redimensionnement par programmation, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms.

Voir aussi

S’applique à

AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode, Boolean)

Ajuste la largeur de la colonne spécifiée à l'aide du mode de dimensionnement spécifié, en calculant éventuellement la largeur dans l'attente que les hauteurs de lignes soient ajustées par la suite.

protected:
 void AutoResizeColumn(int columnIndex, System::Windows::Forms::DataGridViewAutoSizeColumnMode autoSizeColumnMode, bool fixedHeight);
protected void AutoResizeColumn (int columnIndex, System.Windows.Forms.DataGridViewAutoSizeColumnMode autoSizeColumnMode, bool fixedHeight);
member this.AutoResizeColumn : int * System.Windows.Forms.DataGridViewAutoSizeColumnMode * bool -> unit
Protected Sub AutoResizeColumn (columnIndex As Integer, autoSizeColumnMode As DataGridViewAutoSizeColumnMode, fixedHeight As Boolean)

Paramètres

columnIndex
Int32

Index de la colonne à redimensionner.

autoSizeColumnMode
DataGridViewAutoSizeColumnMode

Une des valeurs de l'objet DataGridViewAutoSizeColumnMode.

fixedHeight
Boolean

true pour calculer la nouvelle largeur en fonction des hauteurs de lignes actuelles ; false pour calculer la largeur dans l'attente que les hauteurs de lignes soient également ajustées.

Exceptions

InvalidOperationException

autoSizeColumnMode a la valeur ColumnHeader et ColumnHeadersVisible a la valeur false.

ArgumentException

autoSizeColumnMode a la valeur NotSet, None ou Fill.

ArgumentOutOfRangeException

columnIndex n’appartient pas à la plage valide, qui va de 0 au nombre de colonnes moins 1.

InvalidEnumArgumentException

autoSizeColumnMode n’est pas une valeur de DataGridViewAutoSizeColumnMode valide.

Remarques

Cette méthode est utile si vous souhaitez contrôler quand une colonne est redimensionnée. La largeur de colonne n’est ajustée qu’une seule fois par appel de méthode ; si le contenu de la colonne change ultérieurement, la colonne ne s’ajuste pas automatiquement. Pour redimensionner toutes les colonnes, utilisez la AutoResizeColumns méthode. Pour définir la colonne à redimensionner automatiquement chaque fois que son contenu change, utilisez la AutoSizeColumnsMode propriété ou la propriété de colonne AutoSizeMode .

Cette surcharge vous permet de spécifier un mode de dimensionnement qui calcule la nouvelle largeur en fonction des valeurs d’un ensemble limité de cellules, comme celles des lignes affichées uniquement. Cela améliore les performances lorsque le contrôle contient un grand nombre de lignes.

Cette surcharge est protégée et est conçue pour vous permettre d’obtenir des ratios de hauteur/largeur de cellule idéaux dans une classe dérivée DataGridView . Si fixedHeight c’est le casfalse, la largeur de colonne est calculée avec l’attente que vous appelez la ou AutoResizeRows la AutoResizeRow méthode suivante.

Pour plus d’informations sur le redimensionnement par programmation, consultez Options de dimensionnement dans le contrôle DataGridView Windows Forms.

Voir aussi

S’applique à