Cells in ReoGrid can host a cell body — a component that renders custom content and handles user interaction. ReoGrid provides many built-in cell body types for common UI controls.

Namespace

using unvell.ReoGrid.CellTypes;

Available Cell Types

Class	Sample	Description
ButtonCell		General button
CheckBoxCell		Check box (toggles true/false)
RadioButtonCell		Radio button (mutual exclusion within a group)
HyperlinkCell		Hyperlink with optional auto-navigation
DropdownListCell		Drop-down list for single item selection
ComboListCell		Combo box with text input and drop-down selection
ProgressCell		Progress bar (value 0–1)
NegativeProgressCell		Positive/negative progress bar
ImageCell		Displays an image
ImageButtonCell		Image on a button
DatePickerCell		Date picker with calendar drop-down
ColumnDropdownListCell		Drop-down list using column data as source

Setting a Cell Body

// Via worksheet indexer
sheet[1, 2] = new ButtonCell("Click Me");

// Via cell instance
var cell = sheet.Cells["C3"];
cell.Body = new CheckBoxCell();

ICellBody Interface

All cell bodies implement ICellBody. The CellBody base class provides default implementations:

For creating custom cell bodies, see Custom Cell.

ButtonCell

A clickable button that displays the cell’s data as its label.

// With default text
sheet[1, 2] = new ButtonCell("Hello");

// Without text — uses cell data as label
sheet[1, 2] = new ButtonCell();
sheet[1, 2] = "Hello";

Properties

Events

Methods

var button = new ButtonCell("Hello");
button.Click += (s, e) => MessageBox.Show("Button clicked");
sheet["C3"] = button;

// Programmatic click
button.PerformClick();

Customize Button Appearance

Change the button label color through the cell style:

var cell = sheet.Cells["C3"];
cell.Style.TextColor = Color.Blue;
cell.Body = new ButtonCell("Hello");

CheckBoxCell

A check box that toggles the cell’s data between true and false.

var checkbox = new CheckBoxCell();
sheet["C1"] = new object[] { checkbox, "Auto destroy after 5 minutes." };

Constructors

Properties

Get and Set Check State

// Set via cell data
sheet[1, 2] = true;   // check
sheet[1, 2] = false;  // uncheck

// Get via cell data
bool isChecked = (sheet["C1"] as bool?) ?? false;

// Get/set via checkbox instance
checkbox.IsChecked = true;
bool state = checkbox.IsChecked;

Events

checkbox.Click += (s, e) => { /* handle click */ };

checkbox.CheckChanged += (s, e) =>
{
    Console.WriteLine($"Checked: {checkbox.IsChecked}");
};

Since the checkbox updates cell data, CellDataChanged also fires:

sheet.CellDataChanged += (s, e) =>
{
    if (e.Cell.Position == new CellPosition("C1"))
        Console.WriteLine("Checkbox changed: " + e.Cell.Data);
};

Custom Drawing

Override OnContentPaint to customize checkbox appearance:

class MyCheckBox : CheckBoxCell
{
    Image checkedImage, uncheckedImage;

    public MyCheckBox()
    {
        checkedImage = Image.FromFile(@"...");
        uncheckedImage = Image.FromFile(@"...");
    }

    protected override void OnContentPaint(CellDrawingContext dc)
    {
        dc.Graphics.DrawImage(
            this.IsChecked ? checkedImage : uncheckedImage,
            this.ContentBounds);
    }
}

RadioButtonCell

A radio button that inherits from CheckBoxCell. Radio buttons within the same group toggle each other.

var radio = new RadioButtonCell();
sheet["C3"] = radio;

RadioButtonGroup

Assign a shared RadioButtonGroup so only one radio button can be selected at a time:

var group = new RadioButtonGroup();

sheet[10, 2] = new object[,] {
    { new RadioButtonCell() { RadioGroup = group }, "Apple" },
    { new RadioButtonCell() { RadioGroup = group }, "Orange" },
    { new RadioButtonCell() { RadioGroup = group }, "Banana" },
};

RadioButtonGroup Members

Properties

Events

// Click event
radio.Click += (s, e) => { /* handle */ };

// CheckChanged on all radios in a group
group.RadioButtons.ForEach(rb =>
    rb.CheckChanged += (s, e) =>
        Console.WriteLine("Selected: " + sheet[rb.Cell.Row, rb.Cell.Column + 1]));

DropdownListCell

A drop-down list that lets the user choose from a list of items.

Constructors

var dropdown = new DropdownListCell(
    "Apple", "Orange", "Banana", "Pear",
    "Pumpkin", "Cherry", "Coconut"
);
sheet["B2"] = dropdown;

Properties

Events

dropdown.SelectedItemChanged += (s, e) =>
{
    Console.WriteLine("Selected: " + dropdown.SelectedItem);
};

The selected item is also set as cell data, so CellDataChanged fires too.

Learn more at Drop-down List Cell.

ComboListCell

A combo box that combines a text input field with a drop-down selection list. Supports auto-completion while typing.

Constructors

var combo = new ComboListCell("Apple", "Orange", "Banana");
sheet["B2"] = combo;

Properties

Events

DropdownCell (Base Class)

DropdownCell is the abstract base class for all drop-down cell types. It can be extended to create custom drop-down controls.

Properties

Methods

Events

See How to Create a Custom Drop-down Cell for creating custom drop-down controls.

ProgressCell

Displays a horizontal progress bar. The cell value (0–1) determines the fill amount.

sheet["B2"] = new ProgressCell();
sheet["B2"] = 0.7;  // 70% progress

Properties

var progress = new ProgressCell
{
    TopColor = SolidColor.LightGreen,
    BottomColor = SolidColor.Green,
};
sheet["B2"] = progress;
sheet["B2"] = 0.5;

NegativeProgressCell

Displays progress bars for both positive and negative values. Positive values extend right from center; negative values extend left.

sheet["B2"] = new NegativeProgressCell();
sheet["B2"] = -0.3;  // 30% negative progress

Properties

HyperlinkCell

A clickable hyperlink. Uses the cell data as the display text and navigation URL.

// Auto-navigate to URL on click
sheet[1, 2] = new HyperlinkCell("http://www.google.com", true);

// Or set URL and display text separately
sheet[1, 2] = new HyperlinkCell("http://www.google.com", false);
sheet[1, 2] = "Google";

Constructors

Properties

Events

var link = new HyperlinkCell("http://myurl.com", false);
link.Click += (s, e) => { /* custom handler */ };
sheet["A1"] = link;

Methods

ImageCell

Displays an image inside a cell.

var image = Image.FromFile("photo.jpg");
sheet[2, 6] = new ImageCell(image);

Constructors

Properties

ImageCellViewMode Enum

var imgCell = new ImageCell(img, ImageCellViewMode.Zoom);
sheet["F6"] = imgCell;

Control image position with cell alignment styles:

var cell = sheet.Cells["F6"];
cell.Style.HAlign = ReoGridHorAlign.Center;
cell.Style.VAlign = ReoGridVerAlign.Middle;

ImageButtonCell

A button that displays an image. Inherits from ButtonCell.

sheet["C3"] = new ImageButtonCell(Image.FromFile("Save-32.png"));

Properties

Inherits Click event and PerformClick() method from ButtonCell.

DatePickerCell

A drop-down cell with a month calendar for date selection. WinForms only.

sheet["B2"] = new DatePickerCell();

The selected date is stored as the cell’s data.

Note: DatePickerCell is only available in the WinForms edition. For WPF, see How to Create a Date Picker Cell.

ColumnDropdownListCell

A drop-down list that uses column data as its selection source. WinForms only.

sheet["B2"] = new ColumnDropdownListCell();

Cell Body Size

The size of a cell body is determined by its parent cell, including any padding styles. To make a cell body larger, merge multiple cells:

sheet.MergeRange("B2:D4");
sheet["B2"] = new ButtonCell("Large Button");

Platform Availability

Demo Projects

Examples of built-in cell types are included in the Demo project.

WinForms:

WPF:

Related Topics

• Custom Cell — Creating custom cell bodies
• Drop-down List Cell — Drop-down list details
• How to Create Custom Drop-down Cell — Custom drop-down tutorial
• How to Create Date Picker Cell — WPF date picker tutorial
• Cell — Cell properties and data