ReoGrid provides five mouse events on the worksheet for handling mouse interactions with cells.

Namespace

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

Events

All events use CellMouseEventArgs.

CellMouseEventArgs Properties

Note: The Cell property may be null if the cell has no data or style. Use sheet.CreateAndGetCell(e.CellPosition) to ensure you get a valid cell instance.

CursorStyle Enum

Examples

Cell Mouse Down

sheet.CellMouseDown += (s, e) =>
{
    // Safe: always use CellPosition, not Cell (which may be null)
    var cell = sheet.CreateAndGetCell(e.CellPosition);
    Console.WriteLine($"Clicked cell {e.CellPosition}: {cell.Data}");
};

Cell Mouse Up

sheet.CellMouseUp += (s, e) =>
{
    Console.WriteLine($"Mouse released at {e.CellPosition}, button: {e.Buttons}");
};

Cell Mouse Enter / Leave

sheet.CellMouseEnter += (s, e) =>
{
    // Highlight on hover
    if (e.Cell != null)
    {
        e.Cell.Style.BackColor = SolidColor.LightYellow;
    }
};

sheet.CellMouseLeave += (s, e) =>
{
    if (e.Cell != null)
    {
        sheet.RemoveRangeStyles(e.CellPosition, PlainStyleFlag.BackColor);
    }
};

Cancel Default Behavior

sheet.CellMouseDown += (s, e) =>
{
    if (e.CellPosition.Col == 0)
    {
        // Prevent selection on first column
        e.IsCancelled = true;
    }
};

Change Cursor Style

sheet.CellMouseMove += (s, e) =>
{
    if (e.Cell?.Data != null)
    {
        e.CursorStyle = CursorStyle.Hand;
    }
};

Detect Double Click

sheet.CellMouseDown += (s, e) =>
{
    if (e.Clicks == 2)
    {
        Console.WriteLine($"Double-clicked on {e.CellPosition}");
    }
};

Related Topics

• Keyboard Events — Cell keyboard events
• Cell Editing — Edit mode events
• Selection — Selection events