DataGridView.CurrentCell Propriété

Définition

Obtient ou définit la cellule actuellement active.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

Valeur de propriété

DataGridViewCell qui représente la cellule active ou null s'il n'y a aucune cellule active.The DataGridViewCell that represents the current cell, or null if there is no current cell. La valeur par défaut est la première cellule de la première colonne ou null s'il n'y a aucune cellule dans le contrôle.The default is the first cell in the first column or null if there are no cells in the control.

Attributs

Exceptions

Impossible de définir la valeur de cette propriété, car les modifications apportées à la cellule active ne peuvent pas être validées ni annulées.The value of this property cannot be set because changes to the current cell cannot be committed or canceled.

- ou --or- La cellule spécifiée lors de la définition de cette propriété se trouve dans une ligne ou une colonne masquée.The specified cell when setting this property is in a hidden row or column.

Les appels réentrants sont autorisés uniquement quand DataGridView est lié à un DataSource.Re-entrant calling is only allowed when the DataGridView is bound to a DataSource. Les appels réentrants sont le résultat d’une modification des données sous-jacentes.Re-entrant calling results from a change to the underlying data.

La cellule spécifiée lors de la définition de cette propriété n’est pas dans DataGridView.The specified cell when setting this property is not in the DataGridView.

Exemples

L’exemple de code suivant montre comment s’assurer que la cellule active est visible après le tri en affectant à la propriété FirstDisplayedCell la valeur de la cellule récupérée via la propriété 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. Ce code ne fonctionne qu’avec un contrôle DataGridView indépendant.This code works only with an unbound DataGridView control. Avec un contrôle DataGridView lié à une source de données externe, la cellule active n’est pas automatiquement rendue persistante lors du tri.With a DataGridView control bound to an external data source, the current cell is not automatically persisted when sorting.

Pour exécuter cet exemple, collez le code suivant dans un formulaire qui contient un DataGridView nommé dataGridView1.To run this example, paste the following code into a form that contains a DataGridView named dataGridView1. Dans C#, vous devez également connecter l’événement Sorted au gestionnaire d’événements.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

Remarques

Lorsque vous définissez une cellule en tant que cellule active, elle est défilant dans la vue si elle n’est pas affichée.When you set a cell as the current cell, it will scroll into view if it is not currently displayed. La cellule active ne peut pas être une cellule d’en-tête, une cellule désactivée ou une cellule dans une ligne ou une colonne masquée.The current cell cannot be a header cell, a disabled cell, or a cell in a hidden row or column.

Vous pouvez définir cette propriété sur null pour supprimer temporairement le rectangle de focus, mais lorsque le contrôle reçoit le focus et que la valeur de cette propriété est null, il est automatiquement défini sur la valeur de la propriété 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.

Lorsque vous modifiez la valeur de cette propriété, l’événement SelectionChanged se produit avant l’événement CurrentCellChanged.When you change the value of this property, the SelectionChanged event occurs before the CurrentCellChanged event. Tout gestionnaire d’événements SelectionChanged qui accède à la propriété CurrentCell à ce stade obtient sa valeur précédente.Any SelectionChanged event handler accessing the CurrentCell property at this time will get its previous value.

Lorsque vous liez le DataGridView à une source de données externe, cette propriété est réinitialisée à sa valeur par défaut.When you bind the DataGridView to an external data source, this property is reset to its default value.

S’applique à

Voir aussi