DataGridView.AutoResizeColumn Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ajusta a largura da coluna especificada para se ajustar ao conteúdo das suas células.
Sobrecargas
| Name | Description |
|---|---|
| AutoResizeColumn(Int32) |
Ajusta a largura da coluna especificada para se ajustar ao conteúdo de todas as suas células, incluindo a célula do cabeçalho. |
| AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode) |
Ajusta a largura da coluna especificada usando o modo de tamanho especificado. |
| AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode, Boolean) |
Ajusta a largura da coluna especificada usando o modo de tamanho especificado, calculando opcionalmente a largura com a expectativa de que as alturas das linhas sejam posteriormente ajustadas. |
AutoResizeColumn(Int32)
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
Ajusta a largura da coluna especificada para se ajustar ao conteúdo de todas as suas células, incluindo a célula do cabeçalho.
public:
void AutoResizeColumn(int columnIndex);public void AutoResizeColumn(int columnIndex);member this.AutoResizeColumn : int -> unitPublic Sub AutoResizeColumn (columnIndex As Integer)Parâmetros
- columnIndex
- Int32
O índice da coluna para redimensionar.
Exceções
columnIndex não está no intervalo válido de 0 ao número de colunas menos 1.
Exemplos
O exemplo de código seguinte usa este método para tornar a largura da coluna suficientemente grande para acomodar um novo valor de célula. Este exemplo faz parte de um exemplo maior disponível em Como: Manipular Linhas no Controlo Windows Forms DataGridView.
// 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
Observações
Este método é útil se quiser controlar quando uma coluna redimensiona. A largura da coluna é ajustada apenas uma vez por chamada de método; se o conteúdo da coluna mudar posteriormente, a coluna não se ajustará automaticamente. Para redimensionar todas as colunas, use o AutoResizeColumns método. Para definir a coluna para redimensionar automaticamente sempre que o seu conteúdo mudar, use a AutoSizeColumnsMode propriedade ou a propriedade da coluna AutoSizeMode .
Para mais informações sobre redimensionamento programático, consulte Opções de Dimensionamento no Windows Forms Controlo DataGridView.
Ver também
Aplica-se a
AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode)
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
Ajusta a largura da coluna especificada usando o modo de tamanho especificado.
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)Parâmetros
- columnIndex
- Int32
O índice da coluna para redimensionar.
- autoSizeColumnMode
- DataGridViewAutoSizeColumnMode
Um dos DataGridViewAutoSizeColumnMode valores.
Exceções
autoSizeColumnMode tem o valor ColumnHeader e ColumnHeadersVisible é false.
columnIndex não está no intervalo válido de 0 ao número de colunas menos 1.
autoSizeColumnMode não é um valor válido DataGridViewAutoSizeColumnMode .
Exemplos
O exemplo de código seguinte usa este método para tornar a largura da coluna suficientemente grande para acomodar um novo valor de célula. Este exemplo faz parte de um exemplo maior disponível em Como: Manipular Linhas no Controlo Windows Forms DataGridView.
// 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
Observações
Este método é útil se quiser controlar quando uma coluna redimensiona. A largura da coluna é ajustada apenas uma vez por chamada de método; se o conteúdo da coluna mudar posteriormente, a coluna não se ajustará automaticamente. Para redimensionar todas as colunas, use o AutoResizeColumns método. Para definir a coluna para redimensionar automaticamente sempre que o seu conteúdo mudar, use a AutoSizeColumnsMode propriedade ou a propriedade da coluna AutoSizeMode .
Esta sobrecarga permite-lhe especificar um modo de dimensionamento que calcula a nova largura com base em valores num conjunto limitado de células, como as apenas nas linhas apresentadas. Isto melhora o desempenho quando o controlo contém um grande número de linhas.
Para mais informações sobre redimensionamento programático, consulte Opções de Dimensionamento no Windows Forms Controlo DataGridView.
Ver também
Aplica-se a
AutoResizeColumn(Int32, DataGridViewAutoSizeColumnMode, Boolean)
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
Ajusta a largura da coluna especificada usando o modo de tamanho especificado, calculando opcionalmente a largura com a expectativa de que as alturas das linhas sejam posteriormente ajustadas.
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)Parâmetros
- columnIndex
- Int32
O índice da coluna para redimensionar.
- autoSizeColumnMode
- DataGridViewAutoSizeColumnMode
Um dos DataGridViewAutoSizeColumnMode valores.
- fixedHeight
- Boolean
true para calcular a nova largura com base nas alturas atuais das filas; false calcular a largura com a expectativa de que as alturas das filas também sejam ajustadas.
Exceções
autoSizeColumnMode tem o valor ColumnHeader e ColumnHeadersVisible é false.
columnIndex não está no intervalo válido de 0 ao número de colunas menos 1.
autoSizeColumnMode não é um valor válido DataGridViewAutoSizeColumnMode .
Observações
Este método é útil se quiser controlar quando uma coluna redimensiona. A largura da coluna é ajustada apenas uma vez por chamada de método; se o conteúdo da coluna mudar posteriormente, a coluna não se ajustará automaticamente. Para redimensionar todas as colunas, use o AutoResizeColumns método. Para definir a coluna para redimensionar automaticamente sempre que o seu conteúdo mudar, use a AutoSizeColumnsMode propriedade ou a propriedade da coluna AutoSizeMode .
Esta sobrecarga permite-lhe especificar um modo de dimensionamento que calcula a nova largura com base em valores num conjunto limitado de células, como as apenas nas linhas apresentadas. Isto melhora o desempenho quando o controlo contém um grande número de linhas.
Esta sobrecarga é protegida e foi concebida para permitir alcançar razões ideais entre altura e largura de célula numa classe derivada DataGridView . Se fixedHeight for false, a largura da coluna será calculada com a expectativa de que chame o AutoResizeRow método ou AutoResizeRows a seguir.
Para mais informações sobre redimensionamento programático, consulte Opções de Dimensionamento no Windows Forms Controlo DataGridView.
