DataGridView.AutoResizeRow 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 da linha especificada para adequar-se ao conteúdo das próprias células.
Sobrecargas
AutoResizeRow(Int32) |
Ajusta a altura da linha especificada para adequar-se ao conteúdo de todas as suas células, incluindo a célula de cabeçalho. |
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode) |
Ajusta a altura da linha especificada usando o modo de tamanho indicado. |
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean) |
Ajusta a altura da linha especificada usando o modo de tamanho especificado, opcionalmente calculando a altura com a expectativa de que as larguras de coluna posteriormente serão ajustadas. |
AutoResizeRow(Int32)
Ajusta a altura da linha especificada para adequar-se ao conteúdo de todas as suas células, incluindo a célula de cabeçalho.
public:
void AutoResizeRow(int rowIndex);
public void AutoResizeRow (int rowIndex);
member this.AutoResizeRow : int -> unit
Public Sub AutoResizeRow (rowIndex As Integer)
Parâmetros
- rowIndex
- Int32
O índice da linha a ser redimensionada.
Exceções
rowIndex
não está no intervalo válido de 0 ao número de linhas menos 1.
Exemplos
O exemplo de código a seguir redimensiona a terceira linha em uma DataGridView para ajustar o conteúdo da coluna. 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 SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}
private void SizeThirdRow(Object sender, EventArgs e)
{
dataGridView1.AutoResizeRow(
2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}
Private Sub SizeThirdRow(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button7.Click
Dim thirdRow As Integer = 2
DataGridView1.AutoResizeRow( _
2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)
End Sub
Comentários
Esse método será útil se você quiser controlar quando uma linha for redimensionado. A altura da linha é ajustada apenas uma vez por chamada de método; se o conteúdo da linha for alterado posteriormente, a linha não será ajustada automaticamente. Para redimensionar todas as linhas, use o AutoResizeRows método. Para definir a linha 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
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)
Ajusta a altura da linha especificada usando o modo de tamanho indicado.
public:
void AutoResizeRow(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode);
public void AutoResizeRow (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode);
member this.AutoResizeRow : int * System.Windows.Forms.DataGridViewAutoSizeRowMode -> unit
Public Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode)
Parâmetros
- rowIndex
- Int32
O índice da linha a ser redimensionada.
- autoSizeRowMode
- DataGridViewAutoSizeRowMode
Um dos valores de DataGridViewAutoSizeRowMode.
Exceções
O autoSizeRowMode
tem o valor RowHeader e RowHeadersVisible é false
.
autoSizeRowMode
não é um valor DataGridViewAutoSizeRowMode válido.
rowIndex
não está no intervalo válido de 0 ao número de linhas menos 1.
Exemplos
O exemplo de código a seguir redimensiona a terceira linha em uma DataGridView para ajustar o conteúdo da coluna. 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 SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}
private void SizeThirdRow(Object sender, EventArgs e)
{
dataGridView1.AutoResizeRow(
2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}
Private Sub SizeThirdRow(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button7.Click
Dim thirdRow As Integer = 2
DataGridView1.AutoResizeRow( _
2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)
End Sub
Comentários
Esse método será útil se você quiser controlar quando uma linha for redimensionado. A altura da linha é ajustada apenas uma vez por chamada de método; se o conteúdo da linha for alterado posteriormente, a linha não será ajustada automaticamente. Para redimensionar todas as linhas, use o AutoResizeRows método. Para definir a linha 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 especificar um modo de dimensionamento que calcula a nova altura com base em valores em um conjunto limitado de células, como aquelas em linhas exibidas apenas. 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
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)
Ajusta a altura da linha especificada 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 AutoResizeRow(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
protected void AutoResizeRow (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
member this.AutoResizeRow : int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unit
Protected Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)
Parâmetros
- rowIndex
- Int32
O índice da linha a ser redimensionada.
- autoSizeRowMode
- DataGridViewAutoSizeRowMode
Um dos valores de DataGridViewAutoSizeRowMode.
- fixedWidth
- Boolean
true
para calcular a nova altura com base na largura atual das colunas; false
para calcular a altura com a expectativa de que as larguras da coluna também serão ajustadas.
Exceções
O autoSizeRowMode
tem o valor RowHeader e RowHeadersVisible é false
.
autoSizeRowMode
não é um valor DataGridViewAutoSizeRowMode válido.
rowIndex
não está no intervalo válido de 0 ao número de linhas menos 1.
Comentários
Esse método será útil se você quiser controlar quando uma linha for redimensionado. A altura da linha é ajustada apenas uma vez por chamada de método; se o conteúdo da linha for alterado posteriormente, a linha não será ajustada automaticamente. Para redimensionar todas as linhas, use o AutoResizeRows método. Para definir a linha 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 especificar um modo de dimensionamento que calcula a nova altura com base em valores em um conjunto limitado de células, como aquelas em linhas exibidas apenas. 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 proporções ideais de altura para largura de célula em uma classe derivada DataGridView . Se fixedWidth
forfalse
, a altura da linha será calculada 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.