DataGridView.AutoSizeRowsMode Propriedade
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.
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, setPublic Property AutoSizeRowsMode As DataGridViewAutoSizeRowsModeValor 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.
