DataGridViewAutoSizeColumnsMode Enumeração

  • Referência

Definição

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

Define os valores para especificar como as larguras de colunas são ajustadas.

public enum class DataGridViewAutoSizeColumnsMode
public enum DataGridViewAutoSizeColumnsMode
type DataGridViewAutoSizeColumnsMode = 
Public Enum DataGridViewAutoSizeColumnsMode
Herança
Object
ValueType
Enum
DataGridViewAutoSizeColumnsMode

Campos

AllCells 6

As larguras da coluna são ajustadas para que o conteúdo de todas as células nas colunas, incluindo as células de cabeçalho, caiba nela.
AllCellsExceptHeader 4

As larguras da coluna são ajustadas para que o conteúdo de todas as células nas colunas, exceto as células de cabeçalho, caiba nela.
ColumnHeader 2

As larguras da coluna são ajustadas para que o conteúdo das célula do cabeçalho da coluna caiba nela.
DisplayedCells 10

As larguras da coluna são ajustadas para que o conteúdo de todas as células nas colunas que estão nas linhas exibidas na tela no momento, incluindo as célula de cabeçalho, caiba nela.
DisplayedCellsExceptHeader 8

As larguras da coluna são ajustadas para que o conteúdo de todas as células nas colunas que estão nas linhas exibidas na tela no momento, exceto as célula de cabeçalho, caiba nela.
Fill 16

As larguras da coluna são ajustadas para que as larguras de todas as colunas preencham exatamente a área de exibição do controle, exigindo a rolagem horizontal apenas para manter as larguras da coluna acima dos valores de propriedade MinimumWidth. As larguras da coluna relativas são determinadas pelos valores de propriedade FillWeight relativos.
None 1

As larguras da coluna não são ajustadas automaticamente.

Exemplos

O exemplo de código a seguir ilustra o uso dessa enumeração em um cenário mestre/detalhes em que dois DataGridView controles exibem dados de duas tabelas em uma relação pai/filho. Neste exemplo, o modo de dimensionamento de colunas 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 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

O DataGridView controle pode redimensionar suas colunas para fazê-las preencher a largura horizontal disponível do controle ou para fazê-las exibir o conteúdo completo de todas as células ou das células especificadas.

Com Fill o modo, a largura preferencial de uma coluna é determinada redimensionando todas as colunas nesse modo para que todas as colunas visíveis no controle preencham exatamente a largura horizontal da área de exibição disponível. Com outros modos, a largura de coluna preferencial é a largura mínima necessária para exibir o maior valor de célula de todas as células ou um subconjunto de células nessa coluna, como o subconjunto de células que estão em linhas exibidas no momento. Usar um subconjunto de células para determinar a nova largura é útil para evitar uma penalidade de desempenho ao trabalhar com muitas linhas de dados.

O redimensionamento automático baseado em conteúdo impede que os usuários ajustem as larguras das colunas com o mouse. No entanto, o redimensionamento do usuário está habilitado no modo de preenchimento.

Essa enumeração é usada pela DataGridView propriedade e AutoResizeColumns pelo método de controleAutoSizeColumnsMode.

Para obter mais informações sobre modos de dimensionamento, consulte Opções de dimensionamento no controle Windows Forms DataGridView. Para obter mais informações sobre o modo de preenchimento de coluna em particular, consulte o Modo de Preenchimento de Coluna no controle Windows Forms DataGridView.

Aplica-se a

Confira também