DataGridViewAutoSizeColumnsMode Enumeração
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.
Define valores para especificar como as larguras das colunas são ajustadas.
public enum class DataGridViewAutoSizeColumnsModepublic enum DataGridViewAutoSizeColumnsModetype DataGridViewAutoSizeColumnsMode = Public Enum DataGridViewAutoSizeColumnsMode- Herança
Campos
| Name | Valor | Description |
|---|---|---|
| None | 1 | As larguras das colunas não se ajustam automaticamente. |
| ColumnHeader | 2 | As larguras das colunas ajustam-se para se ajustar ao conteúdo das células do cabeçalho da coluna. |
| AllCellsExceptHeader | 4 | As larguras das colunas ajustam-se para se ajustar ao conteúdo de todas as células das colunas, excluindo as células do cabeçalho. |
| AllCells | 6 | As larguras das colunas ajustam-se para se ajustar ao conteúdo de todas as células das colunas, incluindo as células do cabeçalho. |
| DisplayedCellsExceptHeader | 8 | As larguras das colunas ajustam-se para se ajustar ao conteúdo de todas as células nas colunas que estão nas linhas atualmente exibidas no ecrã, excluindo as células do cabeçalho. |
| DisplayedCells | 10 | As larguras das colunas ajustam-se para se ajustar ao conteúdo de todas as células nas colunas que estão nas linhas atualmente exibidas no ecrã, incluindo as células do cabeçalho. |
| Fill | 16 | As larguras das colunas ajustam-se para que as larguras de todas as colunas preencham exatamente a área de exibição do controlo, exigindo apenas scrolling horizontal para manter as larguras das colunas acima dos MinimumWidth valores das propriedades. As larguras relativas das colunas são determinadas pelos valores relativos FillWeight das propriedades. |
Exemplos
O exemplo de código seguinte ilustra a utilização desta enumeração num cenário mestre/detalhes 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 é Nenhum 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 para que as colunas se ajustem automaticamente sempre que os valores mudam (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
O DataGridView controlo pode redimensionar as suas colunas para que preencham a largura horizontal disponível do controlo ou para que exibam o conteúdo completo de todas as células ou das células especificadas.
Com o Fill modo, a largura preferida de uma coluna é determinada redimensionando todas as colunas nesse modo para que todas as colunas visíveis no controlo preencham exatamente a largura horizontal da área de exibição disponível. Com outros modos, a largura de coluna preferida é a largura mínima necessária para mostrar 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 nas linhas atualmente apresentadas. Usar um subconjunto de células para determinar a nova largura é útil para evitar uma penalização de desempenho ao trabalhar com muitas linhas de dados.
O redimensionamento automático baseado em conteúdo impede que os utilizadores ajustem as larguras das colunas com o rato. No entanto, o redimensionamento do utilizador está ativado no modo de preenchimento.
Esta enumeração é usada pela DataGridViewAutoSizeColumnsMode propriedade de controlo e AutoResizeColumns pelo método.
Para mais informações sobre modos de dimensionamento, consulte Opções de Dimensionamento no Windows Forms Controlo DataGridView. Para mais informações sobre o modo de preenchimento de colunas em particular, veja Modo de Preenchimento de Coluna no Windows Forms Controlo DataGridView.
