DataGridViewAutoSizeColumnMode Enumeração

Definição

Namespace:
System.Windows.Forms
Assembly:
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

Nome Valor Description
NotSet 0

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

A largura da coluna não é ajustada automaticamente.
ColumnHeader 2

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

A largura da coluna é ajustada para ajustar o conteúdo de todas as células na coluna, excluindo a célula de cabeçalho.
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.
DisplayedCellsExceptHeader 8

A largura da coluna é ajustada para ajustar o conteúdo de todas as células na coluna que estão em linhas exibidas atualmente na tela, excluindo a célula de cabeçalho.
DisplayedCells 10

A largura da coluna é ajustada para ajustar o conteúdo de todas as células na coluna que estão em linhas exibidas atualmente na tela, incluindo 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 rolagem horizontal apenas para manter as larguras de coluna acima dos valores da MinimumWidth propriedade. As larguras relativas das colunas são determinadas pelos valores relativos FillWeight da propriedade.

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 fazê-las exibir o conteúdo completo de todas as células ou de células especificadas.

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

Para obter mais informações sobre modos de dimensionamento, consulte Opções de dimensionamento no controle DataGridView dos Windows Forms. Para obter mais informações sobre o modo de preenchimento de coluna em particular, consulte o Modo de Preenchimento de Coluna no controle DataGridView dos Windows Forms.

Aplica-se a

Confira também