DataGridViewAutoSizeColumnMode Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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
- DataGridView
- AutoSizeMode
- AutoSizeColumnsMode
- DataGridViewAutoSizeColumnsMode
- AutoResizeColumn
- AutoResizeColumns
- Dimensionando opções no controle DataGridView dos Windows Forms
- Modo de preenchimento da coluna no controle DataGridView dos Windows Forms
- Como definir os modos de dimensionamento do controle DataGridView dos Windows Forms