DataGridView.CurrentCell Propiedad

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

DataGridViewCell

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: BrowsableAttribute

Excepciones

InvalidOperationException

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.

ArgumentException

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

Compartir vía