DataGridView.AutoResizeRowHeadersWidth 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 largura dos cabeçalhos de linha para adequar-se ao conteúdo do cabeçalho.
Sobrecargas
AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode) |
Ajusta a largura dos cabeçalhos de linha usando o modo de tamanho especificado. |
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode) |
Ajusta a largura dos cabeçalhos de linha com base em alterações no conteúdo do cabeçalho da linha especificado e usando o modo de tamanho especificado. |
AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean) |
Ajusta a largura dos cabeçalhos de linha usando o modo de tamanho especificado, opcionalmente calculando a largura com a expectativa de que as larguras do cabeçalho de linha e/ou coluna serão ajustadas posteriormente. |
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean) |
Ajusta a largura dos cabeçalhos de linha com base em alterações no conteúdo do cabeçalho na linha especificada e usando o modo de tamanho indicado, opcionalmente calculando a largura com a expectativa de que as larguras de cabeçalho de linha e/ou coluna serão ajustadas posteriormente. |
AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)
Ajusta a largura dos cabeçalhos de linha usando o modo de tamanho especificado.
public:
void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)
Parâmetros
- rowHeadersWidthSizeMode
- DataGridViewRowHeadersWidthSizeMode
Um dos valores de DataGridViewRowHeadersWidthSizeMode.
Exceções
O rowHeadersWidthSizeMode
tem o valor EnableResizing ou DisableResizing.
rowHeadersWidthSizeMode
não é um valor DataGridViewRowHeadersWidthSizeMode válido.
Comentários
Esse método será útil se você quiser controlar quando os cabeçalhos de linha forem redimensionado. A largura dos cabeçalhos de linha é ajustada apenas uma vez por chamada de método; se o conteúdo dos cabeçalhos de linha for alterado posteriormente, os cabeçalhos de linha não serão ajustados automaticamente. Para definir os cabeçalhos de linha para redimensionar automaticamente quando seu conteúdo for alterado, use a RowHeadersWidthSizeMode propriedade.
Esse método permite especificar um modo de dimensionamento que calcula a nova largura com base em valores em um conjunto limitado de cabeçalhos, como aqueles 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
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)
Ajusta a largura dos cabeçalhos de linha com base em alterações no conteúdo do cabeçalho da linha especificado e usando o modo de tamanho especificado.
public:
void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)
Parâmetros
- rowIndex
- Int32
O índice do cabeçalho de linha com o conteúdo alterado.
- rowHeadersWidthSizeMode
- DataGridViewRowHeadersWidthSizeMode
Um dos valores de DataGridViewRowHeadersWidthSizeMode.
Exceções
rowIndex
não está no intervalo válido de 0 ao número de linhas menos 1.
rowHeadersWidthSizeMode
tem o valor EnableResizing ou DisableResizing
rowHeadersWidthSizeMode
não é um valor DataGridViewRowHeadersWidthSizeMode válido.
Exemplos
O exemplo de código a seguir ilustra como redimensionar as larguras de cabeçalho de linha com base nas alterações no conteúdo do cabeçalho da primeira linha. 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 SizeFirstRowHeaderToAllHeaders( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeRowHeadersWidth(0, DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders);
}
private void SizeFirstRowHeaderToAllHeaders(Object sender, EventArgs e)
{
dataGridView1.AutoResizeRowHeadersWidth(
0, DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}
Private Sub SizeFirstRowHeaderToAllHeaders(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button8.Click
DataGridView1.AutoResizeRowHeadersWidth( _
DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)
End Sub
Comentários
Esse método será útil se você quiser controlar quando os cabeçalhos de linha forem redimensionados se apenas o conteúdo do cabeçalho na linha especificada tiver sido alterado como resultado de edições ou alterações de usuário em uma fonte de dados associada. A largura dos cabeçalhos de linha é ajustada apenas uma vez por chamada de método se a alteração de conteúdo exigir; se o conteúdo dos cabeçalhos de linha for alterado posteriormente, os cabeçalhos de linha não serão ajustados automaticamente. Para definir os cabeçalhos de linha para redimensionar automaticamente quando seu conteúdo for alterado, use a RowHeadersWidthSizeMode propriedade.
Esse método permite especificar um modo de dimensionamento que calcula a nova largura com base em valores em um conjunto limitado de cabeçalhos, como aqueles 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
AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)
Ajusta a largura dos cabeçalhos de linha usando o modo de tamanho especificado, opcionalmente calculando a largura com a expectativa de que as larguras do cabeçalho de linha e/ou coluna serão ajustadas posteriormente.
protected:
void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
protected void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowsHeight As Boolean)
Parâmetros
- rowHeadersWidthSizeMode
- DataGridViewRowHeadersWidthSizeMode
Um dos valores de DataGridViewRowHeadersWidthSizeMode.
- fixedColumnHeadersHeight
- Boolean
true
para calcular a nova largura com base na altura atual dos cabeçalhos de coluna; false
para calcular a largura com a expectativa da altura dos cabeçalhos de coluna também será ajustada.
- fixedRowsHeight
- Boolean
true
para calcular a nova largura com base nas alturas de linha atuais; false
para calcular a largura com a expectativa de que as alturas de linha também serão ajustadas.
Exceções
O rowHeadersWidthSizeMode
tem o valor EnableResizing ou DisableResizing.
rowHeadersWidthSizeMode
não é um valor DataGridViewRowHeadersWidthSizeMode válido.
Comentários
Esse método será útil se você quiser controlar quando os cabeçalhos de linha forem redimensionado. A largura dos cabeçalhos de linha é ajustada apenas uma vez por chamada de método; se o conteúdo dos cabeçalhos de linha for alterado posteriormente, os cabeçalhos de linha não serão ajustados automaticamente. Para definir os cabeçalhos de linha para redimensionar automaticamente quando seu conteúdo for alterado, use a RowHeadersWidthSizeMode propriedade.
Esse método permite especificar um modo de dimensionamento que calcula a nova largura com base em valores em um conjunto limitado de cabeçalhos, como aqueles 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 os parâmetros ou os fixedColumnHeadersHeight
parâmetros foremfalse
, a largura dos cabeçalhos de linha será calculada com a expectativa de que você chamará métodos como AutoResizeRows e AutoResizeColumnHeadersHeight o fixedRowsHeight
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
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)
Ajusta a largura dos cabeçalhos de linha com base em alterações no conteúdo do cabeçalho na linha especificada e usando o modo de tamanho indicado, opcionalmente calculando a largura com a expectativa de que as larguras de cabeçalho de linha e/ou coluna serão ajustadas posteriormente.
protected:
void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
protected void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowHeight As Boolean)
Parâmetros
- rowIndex
- Int32
O índice da linha que contém o cabeçalho com o conteúdo alterado.
- rowHeadersWidthSizeMode
- DataGridViewRowHeadersWidthSizeMode
Um dos valores de DataGridViewRowHeadersWidthSizeMode.
- fixedColumnHeadersHeight
- Boolean
true
para calcular a nova largura com base na altura atual dos cabeçalhos de coluna; false
para calcular a largura com a expectativa da altura dos cabeçalhos de coluna também será ajustada.
- fixedRowHeight
- Boolean
true
para calcular a nova largura com base na altura atual da linha especificada; false
para calcular a largura com a expectativa de que a altura da linha também será ajustada.
Exceções
rowIndex
não está no intervalo válido de 0 ao número de linhas menos 1.
O rowHeadersWidthSizeMode
tem o valor EnableResizing ou DisableResizing.
rowHeadersWidthSizeMode
não é um valor DataGridViewRowHeadersWidthSizeMode válido.
Comentários
Esse método será útil se você quiser controlar quando os cabeçalhos de linha forem redimensionados se apenas o conteúdo do cabeçalho na linha especificada tiver sido alterado como resultado de edições ou alterações de usuário em uma fonte de dados associada. A largura dos cabeçalhos de linha é ajustada apenas uma vez por chamada de método se a alteração de conteúdo exigir; se o conteúdo dos cabeçalhos de linha for alterado posteriormente, os cabeçalhos de linha não serão ajustados automaticamente. Para definir os cabeçalhos de linha para redimensionar automaticamente quando seu conteúdo for alterado, use a RowHeadersWidthSizeMode propriedade.
Esse método permite especificar um modo de dimensionamento que calcula a nova largura com base em valores em um conjunto limitado de cabeçalhos, como aqueles 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 os parâmetros ou os fixedColumnHeadersHeight
parâmetros foremfalse
, a largura dos cabeçalhos de linha será calculada com a expectativa de que você chamará métodos como AutoResizeRows e AutoResizeColumnHeadersHeight o fixedRowHeight
próximo.
Para obter mais informações sobre o redimensionamento programático, consulte Opções de Dimensionamento no controle Windows Forms DataGridView.