DataGridView.AutoSizeColumnsMode Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define um valor que indica como as larguras de coluna são determinadas.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { System::Windows::Forms::DataGridViewAutoSizeColumnsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnsMode value); };
public System.Windows.Forms.DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }
member this.AutoSizeColumnsMode : System.Windows.Forms.DataGridViewAutoSizeColumnsMode with get, set
Public Property AutoSizeColumnsMode As DataGridViewAutoSizeColumnsMode

Valor da propriedade

DataGridViewAutoSizeColumnsMode

Um valor DataGridViewAutoSizeColumnsMode. O padrão é None.

Exceções

InvalidEnumArgumentException

O valor especificado ao definir essa propriedade não é um valor DataGridViewAutoSizeColumnsMode válido.

InvalidOperationException

O valor especificado ao definir essa propriedade é ColumnHeader, os cabeçalhos de coluna estão ocultos e, pelo menos, uma coluna visível tem um valor da propriedade AutoSizeMode de NotSet.

- ou - O valor especificado ao definir essa propriedade é Fill e, pelo menos, uma coluna visível com um valor da propriedade AutoSizeMode de NotSet está congelado.

Exemplos

O exemplo de código a seguir ilustra como usar essa propriedade em um cenário mestre/detalhe em que dois DataGridView controles exibem dados de duas tabelas em uma relação pai/filho. Neste exemplo, o modo de dimensionamento de coluna para o controle mestre é None, e as larguras de coluna são inicializadas programaticamente para se ajustar aos valores carregados. O controle de detalhes é definido como um modo de dimensionamento automático de colunas para que as colunas sejam ajustadas automaticamente sempre que os valores forem alterados (por exemplo, quando o usuário alterar a linha atual na tabela pai). Este exemplo faz parte de um exemplo maior disponível em How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls.

private void Form1_Load(object sender, System.EventArgs e)
{
    // Bind the DataGridView controls to the BindingSource
    // components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource;
    detailsDataGridView.DataSource = detailsBindingSource;
    GetData();

    // Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns();

    // Configure the details DataGridView so that its columns automatically
    // adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = 
        DataGridViewAutoSizeColumnsMode.AllCells;
}

Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Load

    ' Bind the DataGridView controls to the BindingSource
    ' components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource
    detailsDataGridView.DataSource = detailsBindingSource
    GetData()

    ' Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns()

    ' Configure the details DataGridView so that its columns automatically
    ' adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = _
        DataGridViewAutoSizeColumnsMode.AllCells

End Sub

Comentários

Essa propriedade permite que você configure o controle para que as larguras de coluna sejam ajustadas automaticamente para preencher o controle ou ajustar o conteúdo da célula. Os ajustes de tamanho ocorrem no modo de preenchimento sempre que a largura do controle é alterada. Nos modos de dimensionamento baseados em conteúdo, os ajustes de tamanho ocorrem sempre que o conteúdo da célula é alterado ou, se WrapMode estiver habilitado, sempre que as alturas das linhas forem alteradas. Alguns modos de dimensionamento baseados em conteúdo permitem limitar o ajuste de tamanho às linhas exibidas no momento para aumentar o desempenho.

Para alterar o modo de dimensionamento de uma coluna individual, defina sua AutoSizeMode propriedade. O valor padrão dessa propriedade é NotSet, indicando que a coluna herda seu comportamento e seu InheritedAutoSizeMode valor de propriedade do controle.

As colunas no modo de preenchimento dividem a largura do controle disponível em proporções indicadas por seus FillWeight valores de propriedade. A largura disponível para o modo de preenchimento é determinada pela subtração das larguras de todas as outras colunas da largura da área do cliente do controle. Se essa largura for menor que os valores combinados MinimumWidth de todas as colunas de modo de preenchimento, a barra de rolagem horizontal será exibida, todas as colunas de modo de preenchimento serão mostradas com suas larguras mínimas e o redimensionamento de coluna do usuário será desabilitado. Para obter mais informações sobre o modo de preenchimento de coluna, consulte o Modo de Preenchimento de Coluna no controle Windows Forms DataGridView.

Somente colunas com um Visible valor de propriedade são true redimensionadas automaticamente e alterar a visibilidade de uma coluna não faz com que o redimensionamento ocorra. Além disso, quando as colunas são definidas para redimensionar automaticamente, o usuário não pode ajustar as larguras da coluna com o mouse.

Para ajustar as larguras da coluna programaticamente, use os AutoResizeColumn métodos ou AutoResizeColumns os métodos ou defina a propriedade de coluna Width .

Para obter mais informações sobre o dimensionamento automático baseado em conteúdo, consulte Opções de dimensionamento no controle Windows Forms DataGridView.

Aplica-se a

Confira também