DataGridView.CellClick, événement

Cet événement se produit lorsque l'utilisateur clique sur une partie d'une cellule, y compris les bordures et les marges. Il se produit également lorsque l'utilisateur appuie sur la touche ESPACE et la relâche pendant qu'une cellule de bouton ou une cellule de case à cocher a le focus, et il se produit deux fois pour ces types de cellules lorsqu'un clic est effectué sur la cellule alors que la touche ESPACE est enfoncée.

Pour déterminer le moment où l'utilisateur clique sur le contenu de la cellule, gérez l'événement CellContentClick.

Cet événement ne reçoit pas d'informations à propos de la position de la souris. Si le gestionnaire d'événements a besoin d'informations à propos de la position de la souris, utilisez l'événement CellMouseClick.

Pour des clics dans un DataGridViewCheckBoxCell, cet événement se produit avant que la case à cocher change la valeur ; ainsi, si vous ne souhaitez pas calculer la valeur attendue en fonction de la valeur actuelle, vous gérerez généralement l'événement DataGridView.CellValueChanged à la place. Puisque cet événement se produit uniquement lorsque la valeur spécifiée par utilisateur est validée, ce qui se produit généralement lorsque le focus quitte la cellule, vous devez également gérer l'événement DataGridView.CurrentCellDirtyStateChanged. Dans ce gestionnaire, si la cellule active est une cellule de case à cocher, appelez la méthode DataGridView.CommitEdit et passez la valeur Commit.

Pour plus d'informations sur la gestion d'événements, consultez Consommation d'événements.

L'exemple de code suivant illustre un gestionnaire d'événements CellClick dans une implémentation du jeu Tic-Tac-Toe qui utilise des colonnes d'image dans un contrôle DataGridView. À moins que le jeu soit terminé ou que l'utilisateur ait déjà cliqué sur la cellule, le gestionnaire d'événements affecte à la valeur de la cellule l'un des deux objets Bitmap représentés par les variables x et o.

Ce code fait partie d'un exemple plus complet disponible dans Comment : utiliser des colonnes de type image dans le contrôle DataGridView Windows Forms.

private void dataGridView1_CellClick(object sender,
    DataGridViewCellEventArgs e)
{

    if (turn.Text.Equals(gameOverString)) { return; }

    DataGridViewImageCell cell = (DataGridViewImageCell)
        dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];

    if (cell.Value == blank)
    {
        if (IsOsTurn())
        {
            cell.Value = o;
        }
        else
        {
            cell.Value = x;
        }
        ToggleTurn();
    }
    if (IsAWin())
    {
        turn.Text = gameOverString;
    }
}

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Référence

Autres ressources