DataGridView.ProcessDataGridViewKey(KeyEventArgs) Méthode

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.

Traite les touches utilisées pour naviguer dans le DataGridView.

protected:
 virtual bool ProcessDataGridViewKey(System::Windows::Forms::KeyEventArgs ^ e);

protected virtual bool ProcessDataGridViewKey (System.Windows.Forms.KeyEventArgs e);

abstract member ProcessDataGridViewKey : System.Windows.Forms.KeyEventArgs -> bool
override this.ProcessDataGridViewKey : System.Windows.Forms.KeyEventArgs -> bool

Protected Overridable Function ProcessDataGridViewKey (e As KeyEventArgs) As Boolean

Paramètres

e: KeyEventArgs

Contient des informations à propos de la touche enfoncée.

Retours

Boolean

true si la touche a été traitée ; sinon, false.

Exceptions

InvalidCastException

La touche activée provoque l’entrée du contrôle en mode d’édition, mais la propriété EditType de la cellule active n’indique pas une classe qui dérive de Control et implémente IDataGridViewEditingControl.

Exception

Cette opération permet de valider une valeur de cellule ou d’activer le mode édition, mais une erreur dans la source de données bloque l’opération : soit il n’existe aucun gestionnaire pour l’événement DataError, soit le gestionnaire a défini la propriété ThrowException sur true.

- ou -

La touche Suppression supprime une ou plusieurs lignes, mais une erreur dans la source de données empêche la suppression et il n’existe aucun gestionnaire pour l’événement DataError ou le gestionnaire a défini la propriété ThrowException avec la valeur true.

Exemples

L’exemple de code suivant montre comment modifier le comportement de la clé ENTER dans une DataGridView sous-classe en remplaçant les ProcessDataGridViewKey méthodes et ProcessDialogKey . Dans l’exemple, la touche ENTRÉE a le même comportement que la touche FLÈCHE DROITE, ce qui permet à un utilisateur de modifier plus facilement plusieurs cellules dans une seule ligne de données.

public class CustomDataGridView : DataGridView
{
    protected override bool ProcessDialogKey(Keys keyData)
    {
        // Extract the key code from the key value. 
        Keys key = (keyData & Keys.KeyCode);

        // Handle the ENTER key as if it were a RIGHT ARROW key. 
        if (key == Keys.Enter)
        {
            return this.ProcessRightKey(keyData);
        }
        return base.ProcessDialogKey(keyData);
    }

    protected override bool ProcessDataGridViewKey(KeyEventArgs e)
    {
        // Handle the ENTER key as if it were a RIGHT ARROW key. 
        if (e.KeyCode == Keys.Enter)
        {
            return this.ProcessRightKey(e.KeyData);
        }
        return base.ProcessDataGridViewKey(e);
    }
}

Public Class CustomDataGridView
    Inherits DataGridView

    <System.Security.Permissions.UIPermission( _
        System.Security.Permissions.SecurityAction.LinkDemand, _
        Window:=System.Security.Permissions.UIPermissionWindow.AllWindows)> _
    Protected Overrides Function ProcessDialogKey( _
        ByVal keyData As Keys) As Boolean

        ' Extract the key code from the key value. 
        Dim key As Keys = keyData And Keys.KeyCode

        ' Handle the ENTER key as if it were a RIGHT ARROW key. 
        If key = Keys.Enter Then
            Return Me.ProcessRightKey(keyData)
        End If

        Return MyBase.ProcessDialogKey(keyData)

    End Function

    <System.Security.Permissions.SecurityPermission( _
        System.Security.Permissions.SecurityAction.LinkDemand, Flags:= _
        System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
    Protected Overrides Function ProcessDataGridViewKey( _
        ByVal e As System.Windows.Forms.KeyEventArgs) As Boolean

        ' Handle the ENTER key as if it were a RIGHT ARROW key. 
        If e.KeyCode = Keys.Enter Then
            Return Me.ProcessRightKey(e.KeyData)
        End If

        Return MyBase.ProcessDataGridViewKey(e)

    End Function

End Class

Remarques

Cette méthode appelle la méthode de traitement des touches appropriée à la touche enfoncée (par exemple, la ProcessF2Key méthode lorsque la touche F2 est enfoncée) et retourne la valeur de retour de cette méthode.

Notes pour les héritiers

Lors de la substitution de cette méthode, un contrôle doit revenir true pour indiquer qu’il a traité la clé. Pour les clés qui ne sont pas traitées par le contrôle, retournez le résultat de la version de base de cette méthode.

S’applique à

Voir aussi

DataGridView, contrôle (Windows Forms)