DataGridView.CurrentCell Propriété
Définition
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, setPublic Property CurrentCell As DataGridViewCellValeur de propriété
Qui DataGridViewCell représente la cellule active, ou null s’il n’y a pas de cellule active. La valeur par défaut est la première cellule de la première colonne ou null s’il n’y a pas de cellules dans le contrôle.
- Attributs
Exceptions
La valeur de cette propriété ne peut pas être définie, car les modifications apportées à la cellule active ne peuvent pas être validées ou annulées.
- ou -
Cellule spécifiée lors de la définition de cette propriété se trouve dans une ligne ou une colonne masquée.
L’appel de réinscrit n’est autorisé que lorsque l’appel DataGridView est lié à un DataSource. Réinscrire les résultats de l’appel d’une modification aux données sous-jacentes.
La cellule spécifiée lors de la définition de cette propriété n’est pas dans le DataGridViewfichier .
Exemples
L’exemple de code suivant montre comment vérifier 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 indépendant 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 nom 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 comme cellule active, elle fait défiler l’affichage s’il n’est pas affiché actuellement. 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é pour null 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, elle est automatiquement définie 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 une DataGridView source de données externe, cette propriété est réinitialisée à sa valeur par défaut.
