DataGridView.ProcessDialogKey(Keys) Méthode
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.
Traite les touches, telles que tabulation, échappement, entrée et touches de direction, utilisées pour contrôler les boîtes de dialogue.
protected:
override bool ProcessDialogKey(System::Windows::Forms::Keys keyData);protected override bool ProcessDialogKey(System.Windows.Forms.Keys keyData);override this.ProcessDialogKey : System.Windows.Forms.Keys -> boolProtected Overrides Function ProcessDialogKey (keyData As Keys) As BooleanParamètres
- keyData
- Keys
Combinaison de valeurs au niveau du Keys bit qui représente la clé ou les clés à traiter.
Retours
true si la clé a été traitée ; sinon, false.
Exceptions
La touche enfoncée entraîne l’entrée du contrôle en mode édition, mais la EditType propriété de la cellule active n’indique pas de classe qui dérive Control et implémente IDataGridViewEditingControl.
Cette action validerait une valeur de cellule ou entrerait en mode d’édition, mais une erreur dans la source de données empêche l’action et il n’existe aucun gestionnaire pour l’événement DataError ou le gestionnaire a défini la ThrowException propriété truesur .
Exemples
L’exemple de code suivant montre comment modifier le comportement de la clé ENTER dans une DataGridView sous-classe en remplaçant les méthodes et ProcessDataGridViewKey les ProcessDialogKey méthodes. Dans l’exemple, la touche ENTRÉE a le même comportement que la touche FLÈCHE DROITE, ce qui facilite la modification de plusieurs cellules par un utilisateur 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 est appelée en mode édition pour gérer l’entrée du clavier qui n’est pas gérée par le contrôle d’édition hébergé.
Si une touche est déterminée à ne pas être une touche d’entrée, elle est envoyée à la classe de base pour traitement.
Notes pour les héritiers
En cas de substitution de cette méthode, un contrôle doit retourner 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.
