DataGridView.

AutoSizeColumnsMod
e Propriedade

Definição

Valor da propriedade

DataGridViewAutoSizeColumnsMode

Um valor DataGridViewAutoSizeColumnsMode. O padrão é None.

Exceções

InvalidEnumArgumentException
O valor especificado ao definir essa propriedade não é um
valor DataGridViewAutoSizeColumnsMode válido.

InvalidOperationException

O valor especificado ao definir essa propriedade é ColumnHeader, os

cabeçalhos de coluna estão ocultos e, pelo menos, uma coluna visível tem um
valor da propriedade AutoSizeMode de NotSet.

- ou - O valor especificado ao definir essa propriedade é Fill e, pelo menos,

uma coluna visível com um valor da
propriedade AutoSizeMode de NotSet está congelado.

Exemplos
O exemplo de código a seguir ilustra como usar essa propriedade em um
cenário mestre/detalhe em que dois DataGridView controles exibem dados de
duas tabelas em uma relação pai/filho. Neste exemplo, o modo de
dimensionamento de coluna para o controle mestre é None, e as larguras de
coluna são inicializadas programaticamente para se ajustar aos valores
carregados. O controle de detalhes é definido como um modo de
dimensionamento automático de colunas para que as colunas sejam ajustadas
automaticamente sempre que os valores forem alterados (por exemplo,
quando o usuário alterar a linha atual na tabela pai). Este exemplo faz parte de
um exemplo maior disponível em How to: Create a Master/Detail Form Using
Two Windows Forms DataGridView Controls.

Comentários
Essa propriedade permite que você configure o controle para que as larguras
de coluna sejam ajustadas automaticamente para preencher o controle ou
ajustar o conteúdo da célula. Os ajustes de tamanho ocorrem no modo de
preenchimento sempre que a largura do controle é alterada. Nos modos de
dimensionamento baseados em conteúdo, os ajustes de tamanho ocorrem
sempre que o conteúdo da célula é alterado ou, se WrapMode estiver
habilitado, sempre que as alturas das linhas forem alteradas. Alguns modos de
dimensionamento baseados em conteúdo permitem limitar o ajuste de
tamanho às linhas exibidas no momento para aumentar o desempenho.

Para alterar o modo de dimensionamento de uma coluna individual, defina

sua AutoSizeMode propriedade. O valor padrão dessa propriedade é NotSet,
indicando que a coluna herda seu comportamento e
seu InheritedAutoSizeMode valor de propriedade do controle.

As colunas no modo de preenchimento dividem a largura do controle

disponível em proporções indicadas por seus FillWeight valores de
propriedade. A largura disponível para o modo de preenchimento é
determinada pela subtração das larguras de todas as outras colunas da
largura da área do cliente do controle. Se essa largura for menor que os
valores combinados MinimumWidth de todas as colunas de modo de
preenchimento, a barra de rolagem horizontal será exibida, todas as colunas
de modo de preenchimento serão mostradas com suas larguras mínimas e o
redimensionamento de coluna do usuário será desabilitado. Para obter mais
informações sobre o modo de preenchimento de coluna, consulte o Modo de
Preenchimento de Coluna no controle Windows Forms DataGridView.

Somente colunas com um Visible valor de propriedade

são true redimensionadas automaticamente e alterar a visibilidade de uma
coluna não faz com que o redimensionamento ocorra. Além disso, quando as
colunas são definidas para redimensionar automaticamente, o usuário não
pode ajustar as larguras da coluna com o mouse.

Para ajustar as larguras da coluna programaticamente, use

os AutoResizeColumn métodos ou AutoResizeColumns os métodos ou defina
a propriedade de coluna Width .

Para obter mais informações sobre o dimensionamento automático baseado

em conteúdo, consulte Opções de dimensionamento no controle Windows
Forms DataGridView.