DataGridView.ProcessDialogKey(Keys) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

处理用来控制对话框的键，例如 Tab、Esc、Enter 和箭头键。

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

参数

keyData

Keys

Keys 值的按位组合，这些值表示要处理的一个或多个键。

返回

Boolean

如果已处理该键，则为 true；否则为 false。

例外

InvalidCastException

按下的键将导致该控件进入编辑模式，但当前单元格的 EditType 属性不指示派生自 Control 并实现 IDataGridViewEditingControl 的类。

Exception

此操作将提交一个单元格值或者进入编辑模式，但是数据源中的错误禁止执行此操作，DataError 事件没有处理程序，或者处理程序已将 ThrowException 属性设置为 true。

示例

下面的代码示例演示如何通过重写 ProcessDataGridViewKey 和 ProcessDialogKey 方法更改子类中 DataGridView ENTER 键的行为。 在本示例中，ENTER 键的行为与向右键相同，使用户能够更轻松地编辑单行数据中的多个单元格。

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

注解

此方法在编辑模式下调用，用于处理不由托管编辑控件处理的键盘输入。

如果按键确定不是输入键，则会将其发送到基类进行处理。

继承者说明

重写此方法时，控件应返回 true 以指示它已处理密钥。 对于控件未处理的键，返回此方法的基本版本的结果。

另请参阅

• DataGridView 控件（Windows 窗体）