DataGridView.AutoResizeColumn Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee past u de breedte van de opgegeven kolom aan op de inhoud van de cellen.
Overloads
| Name | Description |
|---|---|
| AutoResizeColumn(Int32) |
Hiermee past u de breedte van de opgegeven kolom aan op de inhoud van alle cellen, inclusief de koptekstcel. |
| AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode) |
Hiermee past u de breedte van de opgegeven kolom aan met behulp van de opgegeven groottemodus. |
| AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode, Boolean) |
Hiermee past u de breedte van de opgegeven kolom aan met behulp van de opgegeven groottemodus, eventueel de breedte berekenen met de verwachting dat rijhoogten vervolgens worden aangepast. |
AutoResizeColumn(Int32)
Hiermee past u de breedte van de opgegeven kolom aan op de inhoud van alle cellen, inclusief de koptekstcel.
public:
void AutoResizeColumn(int columnIndex);public void AutoResizeColumn(int columnIndex);member this.AutoResizeColumn : int -> unitPublic Sub AutoResizeColumn (columnIndex As Integer)Parameters
- columnIndex
- Int32
De index van de kolom waarvan u het formaat wilt wijzigen.
Uitzonderingen
columnIndex bevindt zich niet in het geldige bereik van 0 tot het aantal kolommen min 1.
Voorbeelden
In het volgende codevoorbeeld wordt deze methode gebruikt om de kolombreedte groot genoeg te maken voor een nieuwe celwaarde. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in Hoe u: Rijen bewerken in het Windows Forms DataGridView-besturingselement.
// 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
Opmerkingen
Deze methode is handig als u wilt bepalen wanneer de grootte van een kolom wordt gewijzigd. De kolombreedte wordt slechts één keer per methode aangeroepen; als de inhoud van de kolom later wordt gewijzigd, wordt de kolom niet automatisch aangepast. Als u het formaat van alle kolommen wilt wijzigen, gebruikt u de AutoResizeColumns methode. Als u de kolom zo wilt instellen dat de grootte automatisch wordt gewijzigd wanneer de inhoud ervan wordt gewijzigd, gebruikt u de AutoSizeColumnsMode eigenschap of de kolomeigenschap AutoSizeMode .
Zie Sizing Options in the Windows Forms DataGridView Control voor meer informatie over het aanpassen van het formaat van programma's.
Zie ook
Van toepassing op
AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode)
Hiermee past u de breedte van de opgegeven kolom aan met behulp van de opgegeven groottemodus.
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)Parameters
- columnIndex
- Int32
De index van de kolom waarvan u het formaat wilt wijzigen.
- autoSizeColumnMode
- DataGridViewAutoSizeColumnMode
Een van de DataGridViewAutoSizeColumnMode waarden.
Uitzonderingen
autoSizeColumnMode heeft de waarde ColumnHeader en ColumnHeadersVisible is false.
columnIndex bevindt zich niet in het geldige bereik van 0 tot het aantal kolommen min 1.
autoSizeColumnMode is geen geldige DataGridViewAutoSizeColumnMode waarde.
Voorbeelden
In het volgende codevoorbeeld wordt deze methode gebruikt om de kolombreedte groot genoeg te maken voor een nieuwe celwaarde. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in Hoe u: Rijen bewerken in het Windows Forms DataGridView-besturingselement.
// 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
Opmerkingen
Deze methode is handig als u wilt bepalen wanneer de grootte van een kolom wordt gewijzigd. De kolombreedte wordt slechts één keer per methode aangeroepen; als de inhoud van de kolom later wordt gewijzigd, wordt de kolom niet automatisch aangepast. Als u het formaat van alle kolommen wilt wijzigen, gebruikt u de AutoResizeColumns methode. Als u de kolom zo wilt instellen dat de grootte automatisch wordt gewijzigd wanneer de inhoud ervan wordt gewijzigd, gebruikt u de AutoSizeColumnsMode eigenschap of de kolomeigenschap AutoSizeMode .
Met deze overbelasting kunt u een groottemodus opgeven waarmee de nieuwe breedte wordt berekend op basis van waarden in een beperkte set cellen, zoals die in alleen weergegeven rijen. Dit verbetert de prestaties wanneer het besturingselement een groot aantal rijen bevat.
Zie Sizing Options in the Windows Forms DataGridView Control voor meer informatie over het aanpassen van het formaat van programma's.
Zie ook
Van toepassing op
AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode, Boolean)
Hiermee past u de breedte van de opgegeven kolom aan met behulp van de opgegeven groottemodus, eventueel de breedte berekenen met de verwachting dat rijhoogten vervolgens worden aangepast.
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)Parameters
- columnIndex
- Int32
De index van de kolom waarvan u het formaat wilt wijzigen.
- autoSizeColumnMode
- DataGridViewAutoSizeColumnMode
Een van de DataGridViewAutoSizeColumnMode waarden.
- fixedHeight
- Boolean
true om de nieuwe breedte te berekenen op basis van de huidige rijhoogten; false om de breedte te berekenen met de verwachting dat de rijhoogten ook worden aangepast.
Uitzonderingen
autoSizeColumnMode heeft de waarde ColumnHeader en ColumnHeadersVisible is false.
columnIndex bevindt zich niet in het geldige bereik van 0 tot het aantal kolommen min 1.
autoSizeColumnMode is geen geldige DataGridViewAutoSizeColumnMode waarde.
Opmerkingen
Deze methode is handig als u wilt bepalen wanneer de grootte van een kolom wordt gewijzigd. De kolombreedte wordt slechts één keer per methode aangeroepen; als de inhoud van de kolom later wordt gewijzigd, wordt de kolom niet automatisch aangepast. Als u het formaat van alle kolommen wilt wijzigen, gebruikt u de AutoResizeColumns methode. Als u de kolom zo wilt instellen dat de grootte automatisch wordt gewijzigd wanneer de inhoud ervan wordt gewijzigd, gebruikt u de AutoSizeColumnsMode eigenschap of de kolomeigenschap AutoSizeMode .
Met deze overbelasting kunt u een groottemodus opgeven waarmee de nieuwe breedte wordt berekend op basis van waarden in een beperkte set cellen, zoals die in alleen weergegeven rijen. Dit verbetert de prestaties wanneer het besturingselement een groot aantal rijen bevat.
Deze overbelasting is beschermd en is ontworpen om u in staat te stellen ideale celhoogte-breedteverhoudingen in een afgeleide DataGridView klasse te bereiken. Als fixedHeight dat het is false, wordt de kolombreedte berekend met de verwachting dat u de AutoResizeRow of AutoResizeRows methode hierna aanroept.
Zie Sizing Options in the Windows Forms DataGridView Control voor meer informatie over het aanpassen van het formaat van programma's.
