DataGridView.AutoResizeRows Método

Definição

Ajusta as alturas de algumas ou todas as filas para se adaptarem ao seu conteúdo.

Sobrecargas

Name Description
AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

Ajusta as alturas de todas as linhas usando o modo de tamanho especificado, calculando opcionalmente as alturas com a expectativa de que as larguras das colunas sejam posteriormente ajustadas.

AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)

Ajusta as alturas das linhas especificadas usando o modo de tamanho especificado, calculando opcionalmente as alturas com a expectativa de que as larguras das colunas serão posteriormente ajustadas.

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Ajusta as alturas das linhas usando o valor especificado do modo de tamanho.

AutoResizeRows()

Ajusta as alturas de todas as linhas para se ajustarem ao conteúdo de todas as suas células, incluindo as células do cabeçalho.

AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)

Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs

Ajusta as alturas de todas as linhas usando o modo de tamanho especificado, calculando opcionalmente as alturas com a expectativa de que as larguras das colunas sejam posteriormente ajustadas.

protected:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
protected void AutoResizeRows(System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode * bool -> unit
Protected Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode, fixedWidth As Boolean)

Parâmetros

fixedWidth
Boolean

true para calcular as novas alturas com base nas larguras atuais das colunas; false para calcular as alturas com a expectativa de que as larguras das colunas também sejam ajustadas.

Exceções

autoSizeRowsMode tem o valor AllHeaders ou DisplayedHeaders, e RowHeadersVisible é false.

autoSizeRowsMode não é um valor válido DataGridViewAutoSizeRowsMode .

autoSizeRowsMode tem o valor None.

Observações

Este método é útil se quiseres controlar quando as linhas mudam de tamanho. As alturas das filas são ajustadas apenas uma vez por chamada de método; se o conteúdo das linhas mudar posteriormente, as linhas não se ajustarão automaticamente. Para redimensionar uma linha específica, use o AutoResizeRow método. Para redimensionar um subconjunto de linhas, use a AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) sobrecarga. Para definir as linhas para se redimensionarem automaticamente sempre que o seu conteúdo mudar, use a AutoSizeRowsMode propriedade.

Para que o conteúdo das células se enrole em múltiplas linhas quando uma linha é redimensionada, o estilo de célula em vigor para a célula deve ter um WrapMode valor de propriedade de True.

Esta sobrecarga permite-lhe especificar um modo de dimensionamento que calcula as novas alturas com base em valores num conjunto limitado de células, como as apenas nas linhas apresentadas. Isto melhora o desempenho quando o controlo contém um grande número de linhas.

Esta sobrecarga é protegida e foi concebida para permitir alcançar razões ideais entre altura e largura de célula numa classe derivada DataGridView . Se o fixedWidth parâmetro for false, as alturas das linhas serão calculadas com a expectativa de que chame o AutoResizeColumn método ou AutoResizeColumns a seguir.

Para mais informações sobre redimensionamento programático, consulte Opções de Dimensionamento no Windows Forms Controlo DataGridView.

Ver também

Aplica-se a

AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)

Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs

Ajusta as alturas das linhas especificadas usando o modo de tamanho especificado, calculando opcionalmente as alturas com a expectativa de que as larguras das colunas serão posteriormente ajustadas.

protected:
 void AutoResizeRows(int rowIndexStart, int rowsCount, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
protected void AutoResizeRows(int rowIndexStart, int rowsCount, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
member this.AutoResizeRows : int * int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unit
Protected Sub AutoResizeRows (rowIndexStart As Integer, rowsCount As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)

Parâmetros

rowIndexStart
Int32

O índice da primeira linha para redimensionar.

rowsCount
Int32

O número de filas a redimensionar.

fixedWidth
Boolean

true para calcular as novas alturas com base nas larguras atuais das colunas; false para calcular as alturas com a expectativa de que as larguras das colunas também sejam ajustadas.

Exceções

autoSizeRowsMode tem o valor AllHeaders ou DisplayedHeaders, e RowHeadersVisible é false.

autoSizeRowsMode não é um valor válido DataGridViewAutoSizeRowsMode .

autoSizeRowsMode tem o valor None.

rowIndexStart é inferior a 0.

-ou-

rowsCount é inferior a 0.

Observações

Este método é útil se quiser controlar quando as linhas são redimensionadas, mas quiser redimensionar apenas um subconjunto específico de linhas, como aquelas dentro de um intervalo de registos encadernados que foram atualizados. As alturas das linhas especificadas são ajustadas apenas uma vez por chamada de método; se o conteúdo das linhas mudar posteriormente, as linhas não se ajustarão automaticamente. Para redimensionar uma linha específica, use o AutoResizeRow método. Para redimensionar todas as linhas, use uma sobrecarga diferente do AutoResizeRows método. Para definir as linhas para se redimensionarem automaticamente sempre que o seu conteúdo mudar, use a AutoSizeRowsMode propriedade.

Para que o conteúdo das células se enrole em múltiplas linhas quando uma linha é redimensionada, o estilo de célula em vigor para a célula deve ter um WrapMode valor de propriedade de True.

Esta sobrecarga permite-lhe especificar um modo de dimensionamento que calcula as novas alturas com base em valores num conjunto limitado de células, como as apenas nas linhas apresentadas. Isto melhora o desempenho quando o controlo contém um grande número de linhas.

Esta sobrecarga é protegida e foi concebida para permitir alcançar razões ideais entre altura e largura de célula numa classe derivada DataGridView . Se o fixedWidth parâmetro for false, as alturas das linhas serão calculadas com a expectativa de que chame o AutoResizeColumn método ou AutoResizeColumns a seguir.

Para mais informações sobre redimensionamento programático, consulte Opções de Dimensionamento no Windows Forms Controlo DataGridView.

Ver também

Aplica-se a

AutoResizeRows(DataGridViewAutoSizeRowsMode)

Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs

Ajusta as alturas das linhas usando o valor especificado do modo de tamanho.

public:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode);
public void AutoResizeRows(System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode -> unit
Public Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode)

Parâmetros

Exceções

autoSizeRowsMode tem o valor AllHeaders ou DisplayedHeaders, e RowHeadersVisible é false.

autoSizeRowsMode não é um valor válido DataGridViewAutoSizeRowsMode .

autoSizeRowsMode tem o valor None.

Exemplos

O exemplo de código seguinte demonstra como redimensionar todas as linhas com base no conteúdo das células que não sejam cabeçalhos. Este exemplo de código faz parte de um exemplo mais amplo fornecido em How to: Programmatically Redimension Cells to Adequate Content in the Windows Forms DataGridView Control.

void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button11.Click

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Observações

Este método é útil se quiseres controlar quando as linhas mudam de tamanho. As alturas das filas são ajustadas apenas uma vez por chamada de método; se o conteúdo das linhas mudar posteriormente, as linhas não se ajustarão automaticamente. Para redimensionar uma linha específica, use o AutoResizeRow método. Para redimensionar um subconjunto de linhas, use a AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) sobrecarga. Para definir as linhas para se redimensionarem automaticamente sempre que o seu conteúdo mudar, use a AutoSizeRowsMode propriedade.

Para que o conteúdo das células se enrole em múltiplas linhas quando uma linha é redimensionada, o estilo de célula em vigor para a célula deve ter um WrapMode valor de propriedade de True.

Esta sobrecarga permite-lhe especificar um modo de dimensionamento que calcula as novas alturas com base em valores num conjunto limitado de células, como as apenas nas linhas apresentadas. Isto melhora o desempenho quando o controlo contém um grande número de linhas.

Para mais informações sobre redimensionamento programático, consulte Opções de Dimensionamento no Windows Forms Controlo DataGridView.

Ver também

Aplica-se a

AutoResizeRows()

Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs
Origem:
DataGridView.Methods.cs

Ajusta as alturas de todas as linhas para se ajustarem ao conteúdo de todas as suas células, incluindo as células do cabeçalho.

public:
 void AutoResizeRows();
public void AutoResizeRows();
member this.AutoResizeRows : unit -> unit
Public Sub AutoResizeRows ()

Exemplos

O exemplo de código seguinte demonstra como redimensionar todas as linhas com base no conteúdo das células que não sejam cabeçalhos. Este exemplo de código faz parte de um exemplo mais amplo fornecido em How to: Programmatically Redimension Cells to Adequate Content in the Windows Forms DataGridView Control.

void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button11.Click

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

Observações

Este método é útil se quiseres controlar quando as linhas mudam de tamanho. As alturas das filas são ajustadas apenas uma vez por chamada de método; se o conteúdo das linhas mudar posteriormente, as linhas não se ajustarão automaticamente. Para redimensionar uma linha específica, use o AutoResizeRow método. Para redimensionar um subconjunto de linhas, use a AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) sobrecarga. Para definir as linhas para se redimensionarem automaticamente sempre que o seu conteúdo mudar, use a AutoSizeRowsMode propriedade.

Para que o conteúdo das células se enrole em múltiplas linhas quando uma linha é redimensionada, o estilo de célula em vigor para a célula deve ter um WrapMode valor de propriedade de True.

Para mais informações sobre redimensionamento programático, consulte Opções de Dimensionamento no Windows Forms Controlo DataGridView.

Ver também

Aplica-se a