ReoGrid 在工作表上提供三个键盘事件，用于处理单元格内的按键操作。

命名空间

using unvell.ReoGrid;
using unvell.ReoGrid.Events;
using unvell.ReoGrid.Interaction;

事件

事件参数属性

CellKeyDownEventArgs

所有键盘事件参数的基类。

BeforeCellKeyDownEventArgs

继承自 CellKeyDownEventArgs。

KeyCode 枚举

KeyCode 枚举（标志）表示键盘按键。常用值：

修饰键标志

使用按位与检查修饰键：

if ((e.KeyCode & KeyCode.Control) == KeyCode.Control)
{
    // Ctrl 键被按住
}

示例

取消默认按键行为

阻止 Enter 键移动选区：

sheet.BeforeCellKeyDown += (s, e) =>
{
    if (e.KeyCode == KeyCode.Enter)
    {
        e.IsCancelled = true;
    }
};

检测组合键

sheet.BeforeCellKeyDown += (s, e) =>
{
    if (e.KeyCode == (KeyCode.Control | KeyCode.S))
    {
        // 按下了 Ctrl+S
        SaveWorkbook();
        e.IsCancelled = true;
    }
};

处理按键释放

sheet.CellKeyUp += (s, e) =>
{
    Console.WriteLine($"Key released: {e.KeyCode} at cell {e.CellPosition}");
};

处理按键按下后事件

sheet.AfterCellKeyDown += (s, e) =>
{
    if (e.KeyCode == KeyCode.Delete)
    {
        Console.WriteLine($"Cell {e.CellPosition} content cleared");
    }
};

备注

当按键导致单元格进入编辑模式时，键盘事件不会被触发。字符键（A–Z、0–9、符号）通常会在可编辑单元格上触发编辑模式。在这种情况下，只有 BeforeCellKeyDown 会触发（在编辑模式开始之前）。使用单元格编辑事件来处理编辑期间的输入。

相关主题

• 单元格编辑 — 编辑事件（BeforeCellEdit、AfterCellEdit、CellEditCharInputed）
• 鼠标事件 — 单元格鼠标事件
• 快捷键 — 内置键盘快捷键