DataGridView.FirstDisplayedCell Propriedade

Definição

Obtém ou define a primeira célula atualmente exibida no DataGridView; normalmente, esta célula está 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)>]
member this.FirstDisplayedCell : System.Windows.Forms.DataGridViewCell with get, set
Public Property FirstDisplayedCell As DataGridViewCell

Valor de Propriedade

A primeira DataGridViewCell está atualmente exibida no controlo.

Atributos

Exceções

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

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

-ou-

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

Exemplos

O exemplo de código seguinte ilustra como garantir que a célula atual está visível após a ordenação. Este código funciona apenas com um controlo não vinculado DataGridView . Com um DataGridView controlo vinculado a uma fonte de dados externa, a célula atual não é automaticamente mantida durante a ordenação.

Para executar este exemplo, cole o seguinte código numa forma que contenha um DataGridView .dataGridView1 Em C#, também deve ligar o Sorted evento ao gestor 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

Observações

Pode usar esta propriedade para determinar qual célula está na primeira linha e coluna atualmente apresentada no controlo. Normalmente, isto está no canto superior esquerdo, mas para línguas da direita para a esquerda, está no canto superior direito. Também podes definir esta propriedade para deslocar o controlo até à célula indicada.

Aplica-se a

Ver também