DataGridViewAutoSizeColumnMode Enumeração

  • Referência

Definição

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

Define os 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

AllCells 6

A largura da coluna é ajustada para ajustar o conteúdo de todas as células na coluna, incluindo a célula de cabeçalho.
AllCellsExceptHeader 4

A largura da coluna é ajustada para ajustar o conteúdo de todas as células na coluna, exceto a célula de cabeçalho.
ColumnHeader 2

A largura da coluna é ajustada para ajustar o conteúdo da célula de cabeçalho da coluna.
DisplayedCells 10

A largura da coluna é ajustada para ajustar o conteúdo de todas as células na coluna que estão nas linhas exibidas na tela no momento, incluindo a célula de cabeçalho.
DisplayedCellsExceptHeader 8

A largura da coluna é ajustada para ajustar o conteúdo de todas as células na coluna que estão nas linhas exibidas na tela no momento, exceto a célula de cabeçalho.
Fill 16

A largura da coluna é ajustada 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 da propriedade MinimumWidth. As larguras da coluna relativas são determinadas pelos valores de propriedade FillWeight relativos.
None 1

A largura da coluna não é ajustada automaticamente.
NotSet 0

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

Exemplos

O exemplo de código a seguir ilustra o uso dessa enumeração para configurar uma coluna de largura fixa. Este exemplo faz parte de um exemplo maior disponível em How to: Set the Sizing Modes of the Windows Forms DataGridView Control.

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

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 o modo Preenchimento, 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 pelas propriedades e InheritedAutoSizeMode pelas AutoSizeMode colunas e pelo DataGridView.AutoResizeColumn método.

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