DataGridView.ProcessDialogKey(Keys) Metodo

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Origine:
DataGridView.Methods.cs
Origine:
DataGridView.Methods.cs
Origine:
DataGridView.Methods.cs
Origine:
DataGridView.Methods.cs
Origine:
DataGridView.Methods.cs

Elabora i tasti, ad esempio TAB, ESCAPE, INVIO e FRECCIA, usati per controllare le finestre di dialogo.

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 -> bool
Protected Overrides Function ProcessDialogKey (keyData As Keys) As Boolean

Parametri

keyData
Keys

Combinazione bit per bit di Keys valori che rappresenta la chiave o le chiavi da elaborare.

Valori restituiti

Boolean

true se la chiave è stata elaborata; in caso contrario, false.

Eccezioni

InvalidCastException

Il tasto premuto fa sì che il controllo entri in modalità di modifica, ma la EditType proprietà della cella corrente non indica una classe che deriva da Control e implementa IDataGridViewEditingControl.

Exception

Questa azione eseguirà il commit di un valore di cella o si attiva la modalità di modifica, ma un errore nell'origine dati impedisce l'azione e non esiste alcun gestore per l'evento DataError o il gestore ha impostato la ThrowException proprietà su true.

Esempio

Nell'esempio di codice seguente viene illustrato come modificare il comportamento della chiave ENTER in una DataGridView sottoclasse eseguendo l'override dei ProcessDataGridViewKey metodi e ProcessDialogKey . Nell'esempio, il tasto INVIO ha lo stesso comportamento del tasto FRECCIA DESTRA, rendendo più semplice per un utente modificare più celle in una singola riga di dati.

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

Commenti

Questo metodo viene chiamato in modalità di modifica per gestire l'input da tastiera non gestito dal controllo di modifica ospitato.

Se una pressione di tasto è determinata a non essere un tasto di input, verrà inviata alla classe di base per l'elaborazione.

Note per gli eredi

Quando si esegue l'override di questo metodo, un controllo deve tornare true per indicare che la chiave è stata elaborata. Per le chiavi non elaborate dal controllo, restituire il risultato della versione di base di questo metodo.

Si applica a

Vedi anche