Compartilhar via


DataGridView.AutoSizeRowsMode Propriedade

Definição

Obtém ou define um valor que indica como as alturas das linhas são determinadas.

public:
 property System::Windows::Forms::DataGridViewAutoSizeRowsMode AutoSizeRowsMode { System::Windows::Forms::DataGridViewAutoSizeRowsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeRowsMode value); };
public System.Windows.Forms.DataGridViewAutoSizeRowsMode AutoSizeRowsMode { get; set; }
member this.AutoSizeRowsMode : System.Windows.Forms.DataGridViewAutoSizeRowsMode with get, set
Public Property AutoSizeRowsMode As DataGridViewAutoSizeRowsMode

Valor da propriedade

Um valor DataGridViewAutoSizeRowsMode que indica o modo de dimensionamento. O padrão é None.

Exceções

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

O valor especificado ao definir essa propriedade é AllHeaders ou DisplayedHeaders e os cabeçalhos de linha estão ocultos.

Exemplos

O exemplo de código a seguir demonstra como definir a linha para redimensionar automaticamente com base no conteúdo dos cabeçalhos de linha e em todas as colunas. Este exemplo de código faz parte de um exemplo maior fornecido em How to: Automatically Resize Cells When Content Changes in the Windows Forms DataGridView Control.

void AutoSizeRowsMode( Object^ /*sender*/, EventArgs^ /*es*/ )
{
   dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::AllCells;
}
private void AutoSizeRowsMode(Object sender, EventArgs es)
{
    dataGridView1.AutoSizeRowsMode =
        DataGridViewAutoSizeRowsMode.AllCells;
}
Private Sub AutoSizeRowsMode(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    DataGridView1.AutoSizeRowsMode = _
        DataGridViewAutoSizeRowsMode.AllCells

End Sub

Comentários

Essa propriedade permite configurar o controle para que as alturas de linha sejam ajustadas automaticamente para se ajustarem ao conteúdo sempre que o conteúdo for alterado. Se WrapMode estiver habilitado, as alturas das linhas também serão ajustadas sempre que as larguras das colunas forem alteradas. Alguns modos de dimensionamento permitem limitar o ajuste de tamanho às linhas exibidas no momento para aumentar o desempenho.

Somente linhas com um Visible valor de propriedade de true são redimensionadas automaticamente e alterar a visibilidade de uma linha não faz com que o redimensionamento ocorra. Além disso, quando as linhas são definidas para redimensionar automaticamente, o usuário não pode ajustar as alturas da linha com o mouse.

O Height valor de uma linha de tamanho automático é recalculado durante o layout para considerar o tamanho da fonte usada. Para obter o correto Height, você deve recuperar o valor no evento do Layout formulário em vez de no construtor do formulário.

Para ajustar as alturas da linha programaticamente, use os AutoResizeRow métodos ou AutoResizeRows ou defina a propriedade de linha Height .

Para que o conteúdo da célula seja encapsulado em várias linhas quando uma linha for redimensionada, o estilo da célula em vigor para a célula deve ter um WrapMode valor de propriedade de True.

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

Confira também