DataGridView.CurrentCell Propriété

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit la cellule actuellement active.

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

Valeur de propriété

DataGridViewCell

DataGridViewCell qui représente la cellule active ou null s'il n'y a aucune cellule active. 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.

Attributs: BrowsableAttribute

Exceptions

InvalidOperationException

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.

- ou -

La cellule spécifiée lors de la définition de cette propriété se trouve dans une ligne ou une colonne masquée.

Les appels réentrants sont autorisés uniquement quand DataGridView est lié à un DataSource. Les appels réentrants sont le résultat d’une modification des données sous-jacentes.

ArgumentException

La cellule spécifiée lors de la définition de cette propriété n’est pas dans le DataGridView.

Exemples

L’exemple de code suivant montre comment s’assurer que la cellule active est visible après le tri en définissant la FirstDisplayedCell propriété sur la cellule récupérée via la CurrentCell propriété . Ce code fonctionne uniquement avec un contrôle non lié DataGridView . Avec un DataGridView contrôle lié à une source de données externe, la cellule active n’est pas automatiquement conservée lors du tri.

Pour exécuter cet exemple, collez le code suivant dans un formulaire qui contient un DataGridView nommé dataGridView1. En C#, vous devez également connecter l’événement Sorted au gestionnaire d’événements.

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 défile dans l’affichage si elle n’est pas actuellement affichée. 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.

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 FirstDisplayedCell propriété.

Lorsque vous modifiez la valeur de cette propriété, l’événement SelectionChanged se produit avant l’événement CurrentCellChanged . Tout SelectionChanged gestionnaire d’événements accédant à la CurrentCell propriété à ce stade obtient sa valeur précédente.

Lorsque vous liez à DataGridView une source de données externe, cette propriété est réinitialisée à sa valeur par défaut.

S’applique à

Partage via