DataGridViewAutoSizeColumnMode Enumeração

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll
Origem:
DataGridViewAutoSizeColumnMode.cs
Origem:
DataGridViewAutoSizeColumnMode.cs
Origem:
DataGridViewAutoSizeColumnMode.cs
Origem:
DataGridViewAutoSizeColumnMode.cs
Origem:
DataGridViewAutoSizeColumnMode.cs

Define valores para especificar como a largura de uma coluna é ajustada.

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

Campos

Name Valor Description
NotSet 0

O comportamento de dimensionamento da coluna é herdado da AutoSizeColumnsMode propriedade.
None 1

A largura da coluna não se ajusta automaticamente.
ColumnHeader 2

A largura da coluna ajusta-se para se ajustar ao conteúdo da célula do cabeçalho da coluna.
AllCellsExceptHeader 4

A largura da coluna ajusta-se para se ajustar ao conteúdo de todas as células da coluna, excluindo a célula do cabeçalho.
AllCells 6

A largura da coluna ajusta-se para se ajustar ao conteúdo de todas as células da coluna, incluindo a célula do cabeçalho.
DisplayedCellsExceptHeader 8

A largura da coluna ajusta-se para se ajustar ao conteúdo de todas as células da coluna que estão nas linhas atualmente exibidas no ecrã, excluindo a célula do cabeçalho.
DisplayedCells 10

A largura da coluna ajusta-se para se ajustar ao conteúdo de todas as células da coluna que estão nas linhas atualmente exibidas no ecrã, incluindo a célula do cabeçalho.
Fill 16

A largura das colunas ajusta-se de modo a que as larguras de todas as colunas preencham exatamente a área de visualização do controlo, exigindo apenas scroll 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 para configurar uma coluna de largura fixa. Este exemplo faz parte de um exemplo mais amplo disponível em Como: Definir os Modos de Dimensionamento do Windows Forms Controlo DataGridView.

DataGridViewTextBoxColumn idColumn =
    new DataGridViewTextBoxColumn();
idColumn.HeaderText = "ID";
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None;
idColumn.Resizable = DataGridViewTriState.False;
idColumn.ReadOnly = true;
idColumn.Width = 20;

Dim idColumn As New DataGridViewTextBoxColumn()
idColumn.HeaderText = "ID"
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None
idColumn.Resizable = DataGridViewTriState.False
idColumn.ReadOnly = True
idColumn.Width = 20

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.

No modo de preenchimento, a largura preferida de uma coluna é determinada redimensionando todas as colunas nesse modo, de modo a 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 pelas AutoSizeMode propriedades e InheritedAutoSizeMode das colunas e do DataGridView.AutoResizeColumn 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.

Aplica-se a

Ver também