DataGridView.AutoResizeColumn Méthode
Définition
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.
Ajuste la largeur de la colonne spécifiée pour qu’elle corresponde au contenu de ses cellules.
Surcharges
| Nom | Description |
|---|---|
| AutoResizeColumn(Int32) |
Ajuste la largeur de la colonne spécifiée pour qu’elle corresponde 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 taille spécifié. |
| AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode, Boolean) |
Ajuste la largeur de la colonne spécifiée à l’aide du mode de taille spécifié, en calculant éventuellement la largeur avec l’attente que les hauteurs de ligne seront ensuite ajustées. |
AutoResizeColumn(Int32)
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
Ajuste la largeur de la colonne spécifiée pour qu’elle corresponde 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 -> unitPublic Sub AutoResizeColumn (columnIndex As Integer)Paramètres
- columnIndex
- Int32
Index de la colonne à redimensionner.
Exceptions
columnIndex n’est pas dans la plage valide 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 est ajustée 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)
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
Ajuste la largeur de la colonne spécifiée à l’aide du mode de taille 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 -> unitPublic Sub AutoResizeColumn (columnIndex As Integer, autoSizeColumnMode As DataGridViewAutoSizeColumnMode)Paramètres
- columnIndex
- Int32
Index de la colonne à redimensionner.
- autoSizeColumnMode
- DataGridViewAutoSizeColumnMode
Une des DataGridViewAutoSizeColumnMode valeurs.
Exceptions
autoSizeColumnMode a la valeur ColumnHeader et ColumnHeadersVisible est false.
columnIndex n’est pas dans la plage valide de 0 au nombre de colonnes moins 1.
autoSizeColumnMode n’est pas une valeur valide DataGridViewAutoSizeColumnMode .
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 est ajustée 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, telles que 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)
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
- Source:
- DataGridView.Methods.cs
Ajuste la largeur de la colonne spécifiée à l’aide du mode de taille spécifié, en calculant éventuellement la largeur avec l’attente que les hauteurs de ligne seront ensuite ajustées.
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 -> unitProtected Sub AutoResizeColumn (columnIndex As Integer, autoSizeColumnMode As DataGridViewAutoSizeColumnMode, fixedHeight As Boolean)Paramètres
- columnIndex
- Int32
Index de la colonne à redimensionner.
- autoSizeColumnMode
- DataGridViewAutoSizeColumnMode
Une des DataGridViewAutoSizeColumnMode valeurs.
- fixedHeight
- Boolean
true pour calculer la nouvelle largeur en fonction des hauteurs de ligne actuelles ; false pour calculer la largeur avec l’attente que les hauteurs de ligne seront également ajustées.
Exceptions
autoSizeColumnMode a la valeur ColumnHeader et ColumnHeadersVisible est false.
columnIndex n’est pas dans la plage valide de 0 au nombre de colonnes moins 1.
autoSizeColumnMode n’est pas une valeur valide DataGridViewAutoSizeColumnMode .
Remarques
Cette méthode est utile si vous souhaitez contrôler quand une colonne est redimensionnée. La largeur de colonne est ajustée 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, telles que 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 falsele cas, la largeur de colonne est calculée selon l’attente que vous appelez la méthode 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.
