DataGridView.CurrentCell Propriedade

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll
Origem:
DataGridView.cs
Origem:
DataGridView.cs
Origem:
DataGridView.cs
Origem:
DataGridView.cs
Origem:
DataGridView.cs

Obtém ou definem a célula atualmente ativa.

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

Valor de Propriedade

DataGridViewCell

O DataGridViewCell que representa a célula atual, ou null se não houver célula atual. O padrão é a primeira célula na primeira coluna ou null , se não houver células no controlo.

Atributos
BrowsableAttribute

Exceções

InvalidOperationException

O valor desta propriedade não pode ser definido porque as alterações à célula atual não podem ser comprometidas ou canceladas.

-ou-

A célula especificada ao definir esta propriedade encontra-se numa linha ou coluna oculta.

A chamada reentrante só é permitida quando a DataGridView está ligada a um DataSource. A chamada reentrante resulta de uma alteração nos dados subjacentes.

ArgumentException

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

Exemplos

O exemplo de código seguinte ilustra como garantir que a célula atual é visível após a ordenação, definindo a FirstDisplayedCell propriedade para a célula recuperada através da CurrentCell propriedade. 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

Quando defines uma célula como a célula atual, ela desloca-se para a vista se não estiver atualmente apresentada. A célula atual não pode ser uma célula de cabeçalho, uma célula desativada ou uma célula numa linha ou coluna oculta.

Pode definir esta propriedade para null remover temporariamente o retângulo de foco, mas quando o controlo recebe o foco e o valor desta propriedade é null, é automaticamente definido para o valor da FirstDisplayedCell propriedade.

Quando altera o valor desta propriedade, o SelectionChanged evento ocorre antes do CurrentCellChanged evento. Qualquer gestor de eventos que SelectionChanged aceda à CurrentCell propriedade neste momento recuperará o seu valor anterior.

Quando associa o DataGridView a uma fonte de dados externa, esta propriedade é reposta para o seu valor predefinido.

Aplica-se a

Ver também