Exportar (0) Imprimir
Expandir Tudo
Expandir Minimizar
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Propriedade DataGridView.AutoSizeColumnsMode

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

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

public DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }

ExceçãoCondição
InvalidEnumArgumentException

O valor especificado quando a definição dessa propriedade não é válido DataGridViewAutoSizeColumnsMode valor.

InvalidOperationException

O valor especificado quando a definição dessa propriedade é ColumnHeader, os cabeçalhos de coluna estiverem ocultos e pelo menos uma coluna visível tem um AutoSizeMode valor da propriedade de NotSet.

-ou-

O valor especificado quando a definição dessa propriedade é Fill e pelo menos uma coluna visível com um AutoSizeMode valor da propriedade de NotSet está congelada.

Essa propriedade permite que você configurar o controle para que as larguras de coluna forem automaticamente ajustadas para preencher o controle ou para caber o conteúdo da célula. Ajustes de tamanho ocorrerem no modo de preenchimento, sempre que a largura do controle é alterado. Nos modos de dimensionamento baseados em conteúdo, ajustes de tamanho ocorrerem sempre que a alteração de conteúdo da célula ou, se WrapMode está habilitado, linha sempre que alterar de alturas. Alguns modos de dimensionamento baseados em conteúdo permitem limitar o ajuste de tamanho para as linhas exibidas no momento para aumentar o desempenho.

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

Colunas no modo de preenchimento dividem a largura do controle disponíveis em proporções indicadas por seus FillWeight valores de propriedade. A largura disponível para o modo de preenchimento é determinada subtraindo-se as larguras de todas as outras colunas de largura da área cliente do controle. Se esta largura é menor que o combinado MinimumWidth valores de todas as colunas do modo de preenchimento, a barra de rolagem horizontal é exibida, todas as colunas do modo de preenchimento são mostradas com sua largura mínima, e o redimensionamento de coluna do usuário está desabilitada. Para obter mais informações sobre o modo de preenchimento de coluna, consulte Modo de controle do Windows Forms DataGridView de preenchimento de coluna.

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

Para ajustar as larguras de coluna por programação, use o AutoResizeColumn ou AutoResizeColumns métodos ou definir a coluna Width propriedade.

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

O exemplo de código a seguir ilustra como usar essa propriedade em um cenário mestre/detalhes onde 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 programaticamente são inicializadas para ajustar os valores carregados. O controle de detalhes é definido como um modo de dimensionamento automático de coluna para que as colunas serão ajustadas automaticamente sempre que os valores alterados (por exemplo, quando o usuário altera a linha atual na tabela pai). Este exemplo é parte de um exemplo maior disponível em Como: Criar um formulário mestre/detalhes usando dois controles do Windows Forms DataGridView.


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;
}


.NET Framework

Com suporte em: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft