DataGridView.FirstDisplayedCell Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define a primeira célula exibida no momento o DataGridView, normalmente, essa célula fica no canto superior esquerdo.

public:
 property System::Windows::Forms::DataGridViewCell ^ FirstDisplayedCell { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell FirstDisplayedCell { get; set; }
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell? FirstDisplayedCell { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.FirstDisplayedCell : System.Windows.Forms.DataGridViewCell with get, set
Public Property FirstDisplayedCell As DataGridViewCell

Valor da propriedade

DataGridViewCell

O primeiro DataGridViewCell exibido atualmente em um controle.

Atributos
BrowsableAttribute

Exceções

ArgumentException

A célula especificada ao definir essa propriedade não está no DataGridView.

InvalidOperationException

A célula especificada ao definir essa propriedade tem um valor da propriedade RowIndex ou ColumnIndex de -1, indicando que é uma célula de cabeçalho ou uma célula compartilhada.

- ou -

A célula especificada ao definir essa propriedade tem um valor da propriedade Visible de false.

Exemplos

O exemplo de código a seguir ilustra como garantir que a célula atual esteja visível após a classificação. Esse código funciona apenas com um controle não associado DataGridView . Com um DataGridView controle associado a uma fonte de dados externa, a célula atual não é mantida automaticamente durante a classificação.

Para executar este exemplo, cole o código a seguir em um formulário que contém um DataGridView chamado dataGridView1. Em C#, você também deve conectar o Sorted evento ao manipulador de eventos.

private void dataGridView1_Sorted(object sender, EventArgs e)
{
    this.dataGridView1.FirstDisplayedCell = this.dataGridView1.CurrentCell;
}

Private Sub dataGridView1_Sorted(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles dataGridView1.Sorted

    Me.dataGridView1.FirstDisplayedCell = Me.dataGridView1.CurrentCell

End Sub

Comentários

Você pode usar essa propriedade para determinar qual célula está na primeira linha e coluna atualmente exibidas no controle. Normalmente, isso está no canto superior esquerdo, mas para idiomas da direita para a esquerda, ele está no canto superior direito. Você também pode definir essa propriedade para rolar o controle até a célula indicada.

Aplica-se a

Confira também