DataGridView.AutoResizeColumns Método

Definição

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.

O autoSizeColumnsMode tem o valor None ou Fill.

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.

O autoSizeColumnsMode tem o valor None ou Fill.

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.

Confira também

Aplica-se a