DataGridView.CurrentCell Propriedade
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.
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, setPublic Property CurrentCell As DataGridViewCellValor 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 houver células no controle.
- Atributos
Exceções
O valor dessa propriedade não pode ser definido porque as alterações na célula atual não podem ser confirmadas ou canceladas.
- ou -
A célula especificada ao definir essa propriedade está em uma linha ou coluna oculta.
A chamada de novo participante só é permitida quando a DataGridView chamada é associada a um DataSource. A chamada de novo participante resulta de uma alteração nos dados subjacentes.
A célula especificada ao definir essa propriedade não está na 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 para 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 nome dataGridView1. No 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 para null remover temporariamente o retângulo de foco, mas quando o controle recebe o foco e o valor dessa propriedade é 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 acessar a CurrentCell propriedade neste momento obterá seu valor anterior.
Quando você associa a DataGridView uma fonte de dados externa, essa propriedade é redefinida para seu valor padrão.
