Partilhar via


DataGridView.CurrentCell Propriedade

Definição

Obtém ou define a célula ativa no momento.

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 da propriedade

O DataGridViewCell que representa a célula atual, ou null, se não houver nenhuma célula atual. O padrão é a primeira célula na primeira coluna ou null, se não há nenhuma célula no controle.

Atributos

Exceções

O valor dessa propriedade não pode ser definido porque as alterações feitas na célula atual não podem ser confirmadas nem canceladas.

- ou -

A célula especificada ao definir essa propriedade está em uma linha ou coluna oculta.

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

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

Exemplos

O exemplo de código a seguir ilustra como garantir que a célula atual esteja visível após a classificação definindo a FirstDisplayedCell propriedade como a célula recuperada por meio da CurrentCell propriedade . 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

Quando você definir uma célula como a célula atual, ela rolará para exibição se ela não for exibida no momento. A célula atual não pode ser uma célula de cabeçalho, uma célula desabilitada ou uma célula em uma linha ou coluna oculta.

Você pode definir essa propriedade como null para remover temporariamente o retângulo de foco, mas quando o controle recebe o foco e o valor dessa propriedade é , ele é nulldefinido automaticamente como o valor da FirstDisplayedCell propriedade.

Quando você altera o valor dessa propriedade, o SelectionChanged evento ocorre antes do CurrentCellChanged evento. Qualquer SelectionChanged manipulador de eventos que acesse a CurrentCell propriedade neste momento obterá seu valor anterior.

Quando você associa o DataGridView a uma fonte de dados externa, essa propriedade é redefinida para seu valor padrão.

Aplica-se a

Confira também