DataGridView.AutoSizeColumnsMode Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define um valor que indica como as larguras das colunas 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, setPublic Property AutoSizeColumnsMode As DataGridViewAutoSizeColumnsModeValor de Propriedade
Um valor de DataGridViewAutoSizeColumnsMode. A predefinição é None.
Exceções
O valor especificado ao definir esta propriedade não é um valor válido DataGridViewAutoSizeColumnsMode .
O valor especificado ao definir esta propriedade é ColumnHeader, os cabeçalhos das colunas estão ocultos, e pelo menos uma coluna visível tem um AutoSizeMode valor de propriedade de NotSet.
-ou-
O valor especificado ao definir esta propriedade é Fill e pelo menos uma coluna visível com valor AutoSizeMode de NotSet propriedade está congelada.
Exemplos
O exemplo de código seguinte ilustra como usar esta propriedade num cenário mestre/detalhe onde dois DataGridView controlos exibem dados de duas tabelas numa relação pai/filho. Neste exemplo, o modo de dimensionamento das colunas para o controlo mestre é None, e as larguras das colunas são inicializadas programaticamente para se ajustarem aos valores carregados. O controlo de detalhes está definido para um modo automático de dimensionamento de colunas para que as colunas se ajustem automaticamente sempre que os valores mudem (por exemplo, quando o utilizador altera a linha atual na tabela principal). Este exemplo faz parte de um exemplo maior disponível em Como: Criar um Formulário Mestre/Detalhe Usando Dois Controlos DataGridView Windows Forms.
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
Observações
Esta propriedade permite-lhe configurar o controlo para que as larguras das colunas sejam automaticamente ajustadas, seja para preencher o controlo ou para caber no conteúdo das células. Os ajustes de tamanho ocorrem em modo de preenchimento sempre que a largura do controlo muda. Nos modos de dimensionamento baseados em conteúdo, os ajustes de tamanho ocorrem sempre que o conteúdo das células muda ou, se WrapMode estiver ativado, sempre que a altura das linhas muda. Alguns modos de dimensionamento baseados em conteúdo permitem limitar o ajuste de tamanho às linhas atualmente exibidas para aumentar o desempenho.
Para alterar o modo de dimensionamento de uma coluna individual, defina a sua AutoSizeMode propriedade. O valor padrão desta propriedade é NotSet, indicando que a coluna herda o seu comportamento e o seu InheritedAutoSizeMode valor de propriedade do controlo.
Colunas em modo de preenchimento dividem a largura de controlo disponível em proporções indicadas pelos seus FillWeight valores de propriedade. A largura disponível para o modo de preenchimento é determinada subtraindo as larguras de todas as outras colunas da largura da área cliente do controlo. Se esta largura for menor do que os valores combinados MinimumWidth de todas as colunas de modo de preenchimento, a barra de rolagem horizontal é apresentada, todas as colunas de modo de preenchimento são mostradas com as suas larguras mínimas e o redimensionamento da coluna pelo utilizador fica desativado. Para mais informações sobre o modo de preenchimento de colunas, consulte Modo de Preenchimento de Coluna no Windows Forms Controlo DataGridView.
Apenas colunas com Visible valor de propriedade são true redimensionadas automaticamente, e alterar a visibilidade de uma coluna não provoca redimensionamento. Além disso, quando as colunas são definidas para redimensionar automaticamente, o utilizador não pode ajustar as larguras das colunas com o rato.
Para ajustar as larguras das colunas programaticamente, use os AutoResizeColumn métodos ou AutoResizeColumns defina a propriedade de coluna Width .
Para mais informações sobre dimensionamento automático baseado em conteúdo, consulte Sizing Options no Windows Forms Controlo DataGridView.
