DataGridView.CurrentCell Propiedad

Definición

Obtiene o establece la celda activa actualmente.Gets or sets the currently active cell.

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; }
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.The DataGridViewCell that represents the current cell, or null if there is no current cell. El valor predeterminado es la primera celda de la primera columna o null si no hay ninguna celda en el control.The default is the first cell in the first column or null if there are no cells in the 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.The value of this property cannot be set because changes to the current cell cannot be committed or canceled.

o bien-or- La celda especificada al establecer esta propiedad está en una fila o columna oculta.The specified cell when setting this property is in a hidden row or column.

Solo se permite una llamada reentrante cuando la DataGridView está enlazada a un DataSource.Re-entrant calling is only allowed when the DataGridView is bound to a DataSource. La llamada reentrante se deriva de un cambio en los datos subyacentes.Re-entrant calling results from a change to the underlying data.

La celda especificada al establecer esta propiedad no está en la DataGridView.The specified cell when setting this property is not in the 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 propiedad FirstDisplayedCell en la celda recuperada a través de la propiedad CurrentCell.The following code example illustrates how to ensure that the current cell is visible after sorting by setting the FirstDisplayedCell property to the cell retrieved through the CurrentCell property. Este código solo funciona con un control DataGridView sin enlazar.This code works only with an unbound DataGridView control. Con un control DataGridView enlazado a un origen de datos externo, la celda actual no se conserva automáticamente al ordenar.With a DataGridView control bound to an external data source, the current cell is not automatically persisted when sorting.

Para ejecutar este ejemplo, pegue el código siguiente en un formulario que contenga un DataGridView denominado dataGridView1.To run this example, paste the following code into a form that contains a DataGridView named dataGridView1. En C#, también debe conectar el evento Sorted al controlador de eventos.In C#, you must also connect the Sorted event to the event handler.

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.When you set a cell as the current cell, it will scroll into view if it is not currently displayed. La celda actual no puede ser una celda de encabezado, una celda deshabilitada o una celda de una fila o columna oculta.The current cell cannot be a header cell, a disabled cell, or a cell in a hidden row or column.

Puede establecer esta propiedad en null 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 propiedad FirstDisplayedCell.You can set this property to null to temporarily remove the focus rectangle, but when the control receives focus and the value of this property is null, it is automatically set to the value of the FirstDisplayedCell property.

Al cambiar el valor de esta propiedad, el evento SelectionChanged se produce antes que el evento CurrentCellChanged.When you change the value of this property, the SelectionChanged event occurs before the CurrentCellChanged event. Cualquier controlador de eventos SelectionChanged que tenga acceso a la propiedad CurrentCell en este momento obtendrá su valor anterior.Any SelectionChanged event handler accessing the CurrentCell property at this time will get its previous value.

Al enlazar el DataGridView a un origen de datos externo, esta propiedad se restablece a su valor predeterminado.When you bind the DataGridView to an external data source, this property is reset to its default value.

Se aplica a

Consulte también: