Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como - Avalie este tópico

Propriedade DataGridViewColumn.AutoSizeMode

Obtém ou define o modo pelo qual a coluna ajusta automaticamente sua largura.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)
public DataGridViewAutoSizeColumnMode AutoSizeMode { get; set; }

Valor de propriedade

Tipo: System.Windows.Forms.DataGridViewAutoSizeColumnMode
Um DataGridViewAutoSizeColumnMode valor que determina se a coluna ajustará automaticamente a largura e como ela irá determinar sua largura preferencial. The default is NotSet.
ExceçãoCondição
InvalidEnumArgumentException

O valor especificado quando a definição dessa propriedade é um DataGridViewAutoSizeColumnMode não é válido.

InvalidOperationException

O valor especificado quando a definição dessa propriedade resulta em um InheritedAutoSizeMode valor de ColumnHeader para uma coluna visível quando os cabeçalhos de coluna estiverem ocultos.

-ou-

O valor especificado quando a definição dessa propriedade resulta em um InheritedAutoSizeMode valor de Fill para uma coluna visível que é congelada.

O comportamento de dimensionamento automático da coluna é determinado pelo valor da InheritedAutoSizeMode propriedade, que é igual ao valor da AutoSizeMode propriedade para todos os valores exceto NotSet, que indica que o valor é herdado da DataGridView.AutoSizeColumnsMode propriedade em vez disso.

Quando o InheritedAutoSizeMode valor da propriedade é Fill, a coluna é redimensionada junto com outras colunas no modo. Todas as colunas do modo de preenchimento no controle dividem o espaço disponível em proporções determinado por suas FillWeight valores de propriedade. A largura disponível para o modo de preenchimento é determinada subtraindo-se as larguras de todas as outras colunas de largura da área cliente do controle. Se esta largura é menor que o combinado MinimumWidth valores de todas as colunas do modo de preenchimento, a barra de rolagem horizontal é exibida, todas as colunas do modo de preenchimento são mostradas com sua largura mínima, e o redimensionamento de coluna do usuário está desabilitada. Para obter mais informações sobre o modo de preenchimento de coluna, consulte Modo de controle do Windows Forms DataGridView de preenchimento de coluna.

Quando o InheritedAutoSizeMode for definida como qualquer outro valor, exceto None, a coluna irá gerenciar a sua largura para que seus valores de célula sejam totalmente exibidos sem corte. Nos modos de dimensionamento baseados em conteúdo, ajustes de tamanho ocorrerem sempre que a alteração de conteúdo da célula ou, se WrapMode está habilitado, linha sempre que alterar de alturas. Alguns modos de dimensionamento baseados em conteúdo permitem limitar o ajuste de tamanho para as linhas exibidas no momento para aumentar o desempenho.

Somente colunas com um Visible valor da propriedade de true são redimensionados, e alterar a visibilidade de uma coluna não causará o redimensionamento ocorrer. Além disso, quando as colunas são definidas para redimensionar automaticamente, o usuário não pode ajustar as larguras de coluna com o mouse.

Para ajustar as larguras de coluna por programação, use o DataGridView do controle AutoResizeColumn ou AutoResizeColumns métodos ou definir a coluna Width propriedade.

Para obter mais informações sobre o dimensionamento automático de baseados em conteúdo, consulte Opções de controle do Windows Forms DataGridView de dimensionamento..

O exemplo de código a seguir força a uma coluna para redimensionar automaticamente a sua largura para caber seu conteúdo. This code example is part of a larger example provided for the DataGridViewColumn class.


// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}


.NET Framework

Com suporte em: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.
Isso foi útil para você?
(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
© 2013 Microsoft. Todos os direitos reservados.