DataGridView.AutoResizeColumns 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 de todas as colunas para se ajustar ao conteúdo das suas células.
Sobrecargas
| Name | Description |
|---|---|
| AutoResizeColumns() |
Ajusta a largura de todas as colunas para se ajustar ao conteúdo de todas as suas células, incluindo as células do cabeçalho. |
| AutoResizeColumns(DataGridViewAutoSizeColumnsMode) |
Ajusta a largura de todas as colunas usando o modo de tamanho especificado. |
| AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean) |
Ajusta a largura de todas as colunas usando o modo de tamanho especificado, calculando opcionalmente as larguras com a expectativa de que as alturas das linhas serão posteriormente ajustadas. |
AutoResizeColumns()
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
Ajusta a largura de todas as colunas para se ajustar ao conteúdo de todas as suas células, incluindo as células do cabeçalho.
public:
void AutoResizeColumns();public void AutoResizeColumns();member this.AutoResizeColumns : unit -> unitPublic Sub AutoResizeColumns ()Exemplos
O exemplo de código seguinte redimensiona todas as colunas para se ajustarem ao conteúdo das colunas e aos cabeçalhos das colunas. Este exemplo de código faz parte de um exemplo mais amplo fornecido em How to: Programmatically Redimension Cells to Adequate Content in the Windows Forms DataGridView Control.
void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
dataGridView1.AutoResizeColumns(
DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)
End Sub
Observações
Este método é útil se quiser controlar quando as colunas mudam de tamanho. As larguras das colunas são ajustadas apenas uma vez por chamada de método; se o conteúdo das colunas mudar posteriormente, as colunas não se ajustam automaticamente. Para redimensionar uma coluna específica, use o AutoResizeColumn método. Para configurar as colunas para redimensionarem 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
AutoResizeColumns(DataGridViewAutoSizeColumnsMode)
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
Ajusta a largura de todas as colunas usando o modo de tamanho especificado.
public:
void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);public void AutoResizeColumns(System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode -> unitPublic Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode)Parâmetros
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
Um dos DataGridViewAutoSizeColumnsMode valores.
Exceções
autoSizeColumnsMode tem o valor ColumnHeader e ColumnHeadersVisible é false.
autoSizeColumnsMode não é um valor válido DataGridViewAutoSizeColumnsMode .
Exemplos
O exemplo de código seguinte redimensiona todas as colunas para se ajustarem ao conteúdo das colunas e aos cabeçalhos das colunas. Este exemplo de código faz parte de um exemplo mais amplo fornecido em How to: Programmatically Redimension Cells to Adequate Content in the Windows Forms DataGridView Control.
void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
dataGridView1.AutoResizeColumns(
DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)
End Sub
Observações
Este método é útil se quiser controlar quando as colunas mudam de tamanho. As larguras das colunas são ajustadas apenas uma vez por chamada de método; se o conteúdo das colunas mudar posteriormente, as colunas não se ajustam automaticamente. Para redimensionar uma coluna específica, use o AutoResizeColumn método. Para configurar as colunas para redimensionarem 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 as novas larguras 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
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
- Origem:
- DataGridView.Methods.cs
Ajusta a largura de todas as colunas usando o modo de tamanho especificado, calculando opcionalmente as larguras com a expectativa de que as alturas das linhas serão posteriormente ajustadas.
protected:
void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);protected void AutoResizeColumns(System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode * bool -> unitProtected Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode, fixedHeight As Boolean)Parâmetros
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
Um dos DataGridViewAutoSizeColumnsMode valores.
- fixedHeight
- Boolean
true para calcular as novas larguras com base nas alturas atuais das filas; false para calcular as larguras com a expectativa de que as alturas das filas também sejam ajustadas.
Exceções
autoSizeColumnsMode tem o valor ColumnHeader e ColumnHeadersVisible é false.
autoSizeColumnsMode não é um valor válido DataGridViewAutoSizeColumnsMode .
Observações
Este método é útil se quiser controlar quando as colunas mudam de tamanho. As larguras das colunas são ajustadas apenas uma vez por chamada de método; se o conteúdo das colunas mudar posteriormente, as colunas não se ajustam automaticamente. Para redimensionar uma coluna específica, use o AutoResizeColumn método. Para configurar as colunas para redimensionarem 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 as novas larguras 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, as larguras das colunas serão calculadas com a expectativa de que se 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.
