DataGridView.CurrentCell Propiedad

Definición

Obtiene o establece la celda activa actualmente.

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 propiedad

Objeto DataGridViewCell que representa la celda actual o null si no hay ninguna celda actual. El valor predeterminado es la primera celda de la primera columna o null si no hay ninguna celda en el control.

Atributos

Excepciones

No se puede establecer el valor de esta propiedad porque no se pueden confirmar ni cancelar los cambios realizados en la celda actual.

o bien

La celda especificada al establecer esta propiedad está en una fila o columna oculta.

Solo se permite una llamada reentrante cuando la DataGridView está enlazada a un DataSource. La llamada reentrante se deriva de un cambio en los datos subyacentes.

La celda especificada al establecer esta propiedad no está en la DataGridView.

Ejemplos

En el ejemplo de código siguiente se muestra cómo asegurarse de que la celda actual está visible después de ordenar estableciendo la FirstDisplayedCell propiedad en la celda recuperada a través de la CurrentCell propiedad . Este código solo funciona con un control independiente DataGridView . Con un DataGridView control enlazado a un origen de datos externo, la celda actual no se conserva automáticamente al ordenar.

Para ejecutar este ejemplo, pegue el código siguiente en un formulario que contenga un DataGridView elemento denominado dataGridView1. En C#, también debe conectar el Sorted evento al controlador 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

Comentarios

Al establecer una celda como la celda actual, se desplazará a la vista si no se muestra actualmente. La celda actual no puede ser una celda de encabezado, una celda deshabilitada o una celda de una fila o columna ocultas.

Puede establecer esta propiedad null en para quitar temporalmente el rectángulo de foco, pero cuando el control recibe el foco y el valor de esta propiedad es null, se establece automáticamente en el valor de la FirstDisplayedCell propiedad .

Al cambiar el valor de esta propiedad, el SelectionChanged evento se produce antes del CurrentCellChanged evento . Cualquier SelectionChanged controlador de eventos que tenga acceso a la CurrentCell propiedad en este momento obtendrá su valor anterior.

Al enlazar a DataGridView un origen de datos externo, esta propiedad se restablece a su valor predeterminado.

Se aplica a

Consulte también