DataGridView.AutoResizeRows Método
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.
Ajusta a altura de algumas ou todas as linhas para adequar-se ao conteúdo.
Sobrecargas
AutoResizeRows(DataGridViewAutoSizeRowsMode) |
Ajusta as alturas das linhas usando o valor do modo de tamanho especificado. |
AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) |
Ajusta as alturas das linhas especificadas usando o modo de tamanho indicado, opcionalmente calculando as alturas com a expectativa de que as larguras de coluna serão ajustadas posteriormente. |
AutoResizeRows() |
Ajusta a altura de todas as linhas para ajustar o conteúdo de todas as células, incluindo as células de cabeçalho. |
AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean) |
Ajusta a altura de todas as linhas usando o modo de tamanho especificado, opcionalmente calculando a altura com a expectativa de que as larguras de coluna posteriormente serão ajustadas. |
AutoResizeRows(DataGridViewAutoSizeRowsMode)
Ajusta as alturas das linhas usando o valor do modo de tamanho especificado.
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
- autoSizeRowsMode
- DataGridViewAutoSizeRowsMode
Um dos valores de DataGridViewAutoSizeRowsMode.
Exceções
O autoSizeRowsMode
tem o valor AllHeaders ou DisplayedHeaders e RowHeadersVisible é false
.
autoSizeRowsMode
não é um valor DataGridViewAutoSizeRowsMode válido.
O autoSizeRowsMode
tem o valor None.
Exemplos
O exemplo de código a seguir demonstra como redimensionar todas as linhas com base no conteúdo da célula não cabeçalho. Este exemplo de código faz parte de um exemplo maior fornecido em How to: Programmatically Resize Cells to Fit 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
Comentários
Esse método será útil se você quiser controlar quando as linhas forem redimensionádas. As alturas da linha são ajustadas apenas uma vez por chamada de método; se o conteúdo das linhas for alterado posteriormente, as linhas não serão ajustadas 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 redimensionar automaticamente sempre que seu conteúdo for alterado, use a AutoSizeRowsMode propriedade.
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.
Essa sobrecarga permite que você especifique um modo de dimensionamento que calcula as novas alturas com base em valores em um conjunto limitado de células, como aquelas somente em linhas exibidas. Isso melhora o desempenho quando o controle contém um grande número de linhas.
Para obter mais informações sobre o redimensionamento programático, consulte Opções de dimensionamento no controle Windows Forms DataGridView.
Confira também
Aplica-se a
AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)
Ajusta as alturas das linhas especificadas usando o modo de tamanho indicado, opcionalmente calculando as alturas com a expectativa de que as larguras de coluna serão ajustadas posteriormente.
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 a ser redimensionada.
- rowsCount
- Int32
O número de linhas a serem redimensionadas.
- autoSizeRowMode
- DataGridViewAutoSizeRowMode
Um dos valores de DataGridViewAutoSizeRowMode.
- fixedWidth
- Boolean
true
para calcular a nova altura com base nas larguras atuais das colunas; false
para calcular as alturas com a expectativa de que as larguras da coluna também serão ajustadas.
Exceções
O autoSizeRowsMode
tem o valor AllHeaders ou DisplayedHeaders e RowHeadersVisible é false
.
autoSizeRowsMode
não é um valor DataGridViewAutoSizeRowsMode válido.
O autoSizeRowsMode
tem o valor None.
Comentários
Esse método é útil se você quiser controlar quando as linhas forem redimensionadas, mas você deseja redimensionar apenas um subconjunto específico de linhas, como aquelas dentro de um intervalo de registros associados 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 for alterado posteriormente, as linhas não serão ajustadas 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 redimensionar automaticamente sempre que seu conteúdo for alterado, use a AutoSizeRowsMode propriedade.
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.
Essa sobrecarga permite que você especifique um modo de dimensionamento que calcula as novas alturas com base em valores em um conjunto limitado de células, como aquelas somente em linhas exibidas. Isso melhora o desempenho quando o controle contém um grande número de linhas.
Essa sobrecarga é protegida e foi projetada para permitir que você obtenha as taxas ideais de altura para largura de célula em uma classe derivada DataGridView . Se o fixedWidth
parâmetro forfalse
, as alturas da linha serão calculadas com a expectativa de que você chamará o método ou AutoResizeColumns o AutoResizeColumn próximo.
Para obter mais informações sobre o redimensionamento programático, consulte Opções de dimensionamento no controle Windows Forms DataGridView.
Confira também
Aplica-se a
AutoResizeRows()
Ajusta a altura de todas as linhas para ajustar o conteúdo de todas as células, incluindo as células de cabeçalho.
public:
void AutoResizeRows();
public void AutoResizeRows ();
member this.AutoResizeRows : unit -> unit
Public Sub AutoResizeRows ()
Exemplos
O exemplo de código a seguir demonstra como redimensionar todas as linhas com base no conteúdo da célula não cabeçalho. Este exemplo de código faz parte de um exemplo maior fornecido em How to: Programmatically Resize Cells to Fit 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
Comentários
Esse método será útil se você quiser controlar quando as linhas forem redimensionádas. As alturas da linha são ajustadas apenas uma vez por chamada de método; se o conteúdo das linhas for alterado posteriormente, as linhas não serão ajustadas 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 redimensionar automaticamente sempre que seu conteúdo for alterado, use a AutoSizeRowsMode propriedade.
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 redimensionamento programático, consulte Opções de Dimensionamento no controle Windows Forms DataGridView.
Confira também
Aplica-se a
AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)
Ajusta a altura de todas as linhas usando o modo de tamanho especificado, opcionalmente calculando a altura com a expectativa de que as larguras de coluna posteriormente serão 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
- autoSizeRowsMode
- DataGridViewAutoSizeRowsMode
Um dos valores de DataGridViewAutoSizeRowsMode.
- fixedWidth
- Boolean
true
para calcular a nova altura com base nas larguras atuais das colunas; false
para calcular as alturas com a expectativa de que as larguras da coluna também serão ajustadas.
Exceções
O autoSizeRowsMode
tem o valor AllHeaders ou DisplayedHeaders e RowHeadersVisible é false
.
autoSizeRowsMode
não é um valor DataGridViewAutoSizeRowsMode válido.
O autoSizeRowsMode
tem o valor None.
Comentários
Esse método será útil se você quiser controlar quando as linhas forem redimensionádas. As alturas da linha são ajustadas apenas uma vez por chamada de método; se o conteúdo das linhas for alterado posteriormente, as linhas não serão ajustadas 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 redimensionar automaticamente sempre que seu conteúdo for alterado, use a AutoSizeRowsMode propriedade.
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.
Essa sobrecarga permite que você especifique um modo de dimensionamento que calcula as novas alturas com base em valores em um conjunto limitado de células, como aquelas somente em linhas exibidas. Isso melhora o desempenho quando o controle contém um grande número de linhas.
Essa sobrecarga é protegida e foi projetada para permitir que você obtenha as taxas ideais de altura para largura de célula em uma classe derivada DataGridView . Se o fixedWidth
parâmetro forfalse
, as alturas da linha serão calculadas com a expectativa de que você chamará o método ou AutoResizeColumns o AutoResizeColumn próximo.
Para obter mais informações sobre o redimensionamento programático, consulte Opções de dimensionamento no controle Windows Forms DataGridView.