ReoGrid provides three keyboard events on the worksheet for handling key presses inside cells.

Namespace

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

Events

EventArgs Properties

CellKeyDownEventArgs

Base class for all keyboard event arguments.

BeforeCellKeyDownEventArgs

Extends CellKeyDownEventArgs.

KeyCode Enum

The KeyCode enum (flags) represents keyboard keys. Common values:

Modifier Flags

Check for modifiers using bitwise AND:

if ((e.KeyCode & KeyCode.Control) == KeyCode.Control)
{
    // Ctrl is held
}

Examples

Cancel Default Key Behavior

Prevent Enter from moving the selection:

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

Detect Key Combinations

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

Handle Key Release

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

Handle After Key Down

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

Remarks

Keyboard events are not raised when a key press causes the cell to enter edit mode. Character keys (A–Z, 0–9, symbols) typically trigger edit mode on editable cells. In that case, only BeforeCellKeyDown fires (before edit mode starts). Use Cell Editing events to handle input during editing.

Related Topics

• Cell Editing — Edit events (BeforeCellEdit, AfterCellEdit, CellEditCharInputed)
• Mouse Events — Cell mouse events
• Hot Keys — Built-in keyboard shortcuts