DataGridView.AutoResizeColumns Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ajusta a largura de todas as colunas para adequar-se ao conteúdo das células.
Sobrecargas
AutoResizeColumns() |
Ajusta a largura de todas as colunas que se adéquem ao conteúdo de todas as suas células, incluindo as células de 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, como opção, as larguras com a expectativa de que as alturas das linhas serão ajustadas posteriormente. |
AutoResizeColumns()
Ajusta a largura de todas as colunas que se adéquem ao conteúdo de todas as suas células, incluindo as células de cabeçalho.
public:
void AutoResizeColumns();
public void AutoResizeColumns ();
member this.AutoResizeColumns : unit -> unit
Public Sub AutoResizeColumns ()
Exemplos
O exemplo de código a seguir redimensiona todas as colunas para se ajustar ao conteúdo das colunas e dos cabeçalhos de coluna. Este exemplo de código faz parte de um exemplo maior fornecido em How to: Programmatically Resize Cells to Fit 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
Comentários
Esse método será útil se você quiser controlar quando as colunas forem redimensionádas. As larguras de coluna são ajustadas apenas uma vez por chamada de método; se o conteúdo das colunas for alterado posteriormente, as colunas não serão ajustadas automaticamente. Para redimensionar uma coluna específica, use o AutoResizeColumn método. Para definir as colunas para redimensionar automaticamente sempre que seu conteúdo for alterado, use a AutoSizeColumnsMode propriedade ou a propriedade de coluna AutoSizeMode .
Para obter mais informações sobre o redimensionamento programático, consulte Opções de Dimensionamento no controle Windows Forms DataGridView.
Confira também
Aplica-se a
AutoResizeColumns(DataGridViewAutoSizeColumnsMode)
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 -> unit
Public Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode)
Parâmetros
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
Um dos valores de DataGridViewAutoSizeColumnsMode.
Exceções
O autoSizeColumnsMode
tem o valor ColumnHeader e ColumnHeadersVisible é false
.
autoSizeColumnsMode
não é um valor DataGridViewAutoSizeColumnsMode válido.
Exemplos
O exemplo de código a seguir redimensiona todas as colunas para se ajustar ao conteúdo das colunas e dos cabeçalhos de coluna. Este exemplo de código faz parte de um exemplo maior fornecido em How to: Programmatically Resize Cells to Fit 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
Comentários
Esse método será útil se você quiser controlar quando as colunas forem redimensionádas. As larguras de coluna são ajustadas apenas uma vez por chamada de método; se o conteúdo das colunas for alterado posteriormente, as colunas não serão ajustadas automaticamente. Para redimensionar uma coluna específica, use o AutoResizeColumn método. Para definir as colunas para redimensionar automaticamente sempre que seu conteúdo for alterado, use a AutoSizeColumnsMode propriedade ou a propriedade de coluna AutoSizeMode .
Essa sobrecarga permite especificar um modo de dimensionamento que calcula as novas larguras com base em valores em um conjunto limitado de células, como aquelas somente em linhas exibidas. Isso melhora o desempenho quando o controle contém um grande número de linhas.
Para obter mais informações sobre o redimensionamento programático, consulte Opções de Dimensionamento no controle Windows Forms DataGridView.
Confira também
Aplica-se a
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)
Ajusta a largura de todas as colunas usando o modo de tamanho especificado calculando, como opção, as larguras com a expectativa de que as alturas das linhas serão ajustadas posteriormente.
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 -> unit
Protected Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode, fixedHeight As Boolean)
Parâmetros
- autoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
Um dos valores de DataGridViewAutoSizeColumnsMode.
- fixedHeight
- Boolean
true
para calcular as novas larguras com base nas alturas de linha; false
para calcular as larguras com a expectativa de que as alturas de linha também serão ajustadas.
Exceções
O autoSizeColumnsMode
tem o valor ColumnHeader e ColumnHeadersVisible é false
.
autoSizeColumnsMode
não é um valor DataGridViewAutoSizeColumnsMode válido.
Comentários
Esse método será útil se você quiser controlar quando as colunas forem redimensionádas. As larguras de coluna são ajustadas apenas uma vez por chamada de método; se o conteúdo das colunas for alterado posteriormente, as colunas não serão ajustadas automaticamente. Para redimensionar uma coluna específica, use o AutoResizeColumn método. Para definir as colunas para redimensionar automaticamente sempre que seu conteúdo for alterado, use a AutoSizeColumnsMode propriedade ou a propriedade de coluna AutoSizeMode .
Essa sobrecarga permite especificar um modo de dimensionamento que calcula as novas larguras com base em valores em um conjunto limitado de células, como aquelas somente em linhas exibidas. Isso melhora o desempenho quando o controle contém um grande número de linhas.
Essa sobrecarga é protegida e foi projetada para permitir que você obtenha proporções ideais de altura para largura de célula em uma classe derivada DataGridView . Se fixedHeight
forfalse
, as larguras de coluna serão calculadas com a expectativa de que você chamará o método ou AutoResizeRows o AutoResizeRow próximo.
Para obter mais informações sobre o redimensionamento programático, consulte Opções de Dimensionamento no controle Windows Forms DataGridView.