DataGridViewColumn.AutoSizeMode Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

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

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnMode AutoSizeMode { System::Windows::Forms::DataGridViewAutoSizeColumnMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnMode value); };

public System.Windows.Forms.DataGridViewAutoSizeColumnMode AutoSizeMode { get; set; }

member this.AutoSizeMode : System.Windows.Forms.DataGridViewAutoSizeColumnMode with get, set

Public Property AutoSizeMode As DataGridViewAutoSizeColumnMode

Valor da propriedade

DataGridViewAutoSizeColumnMode

Um valor DataGridViewAutoSizeColumnMode que determina se a coluna ajustará automaticamente a largura e como ela determinará a largura preferencial. O padrão é NotSet.

Exceções

InvalidEnumArgumentException

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

InvalidOperationException

O valor especificado ao definir essa propriedade resulta em um valor InheritedAutoSizeMode de ColumnHeader para uma coluna visível quando os cabeçalhos de coluna estão ocultos.

- ou - O valor especificado ao definir essa propriedade resulta em um valor InheritedAutoSizeMode de Fill para uma coluna visível que está congelada.

Exemplos

O exemplo de código a seguir força uma coluna a redimensionar automaticamente sua largura para ajustar seu conteúdo. Este exemplo de código faz parte de um exemplo maior fornecido para a DataGridViewColumn classe.

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}

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

' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

Comentários

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

Quando o valor da InheritedAutoSizeMode propriedade é Fill, a coluna é redimensionada junto com outras colunas nesse modo. Todas as colunas de modo de preenchimento no controle dividem o espaço disponível em proporções determinadas 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.

Quando a InheritedAutoSizeMode propriedade é definida como qualquer outro valor, exceto None, a coluna gerenciará sua largura para que seus valores de célula sejam totalmente exibidos sem recorte. 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.

Somente colunas com um Visible valor de true propriedade são redimensionadas 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 de coluna programaticamente, use os métodos ou os DataGridView métodos do AutoResizeColumn controle ou defina a propriedade de colunaWidth.AutoResizeColumns

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

Aplica-se a

Compartilhar via