ReoGrid 中的单元格可以托管一个单元格主体 — 一个渲染自定义内容并处理用户交互的组件。ReoGrid 提供了许多内置的单元格主体类型，用于常见的 UI 控件。

命名空间

using unvell.ReoGrid.CellTypes;

可用的单元格类型

类	示例	说明
ButtonCell		通用按钮
CheckBoxCell		复选框（切换 true/false）
RadioButtonCell		单选按钮（同组内互斥）
HyperlinkCell		带可选自动导航的超链接
DropdownListCell		用于单项选择的下拉列表
ComboListCell		带文本输入和下拉选择的组合框
ProgressCell		进度条（值 0–1）
NegativeProgressCell		正/负进度条
ImageCell		显示图片
ImageButtonCell		按钮上的图片
DatePickerCell		带日历下拉的日期选择器
ColumnDropdownListCell		使用列数据作为来源的下拉列表

设置单元格主体

// 通过工作表索引器
sheet[1, 2] = new ButtonCell("Click Me");

// 通过单元格实例
var cell = sheet.Cells["C3"];
cell.Body = new CheckBoxCell();

ICellBody 接口

所有单元格主体都实现 ICellBody。CellBody 基类提供默认实现：

有关创建自定义单元格主体，请参阅 自定义单元格。

ButtonCell

可点击按钮，将单元格数据显示为标签。

// 带默认文本
sheet[1, 2] = new ButtonCell("Hello");

// 不带文本 — 使用单元格数据作为标签
sheet[1, 2] = new ButtonCell();
sheet[1, 2] = "Hello";

属性

事件

方法

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

// 编程方式点击
button.PerformClick();

自定义按钮外观

通过单元格样式更改按钮标签颜色：

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

CheckBoxCell

复选框，将单元格数据在 true 和 false 之间切换。

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

构造函数

属性

获取和设置选中状态

// 通过单元格数据设置
sheet[1, 2] = true;   // 选中
sheet[1, 2] = false;  // 取消选中

// 通过单元格数据获取
bool isChecked = (sheet["C1"] as bool?) ?? false;

// 通过复选框实例获取/设置
checkbox.IsChecked = true;
bool state = checkbox.IsChecked;

事件

checkbox.Click += (s, e) => { /* 处理点击 */ };

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

由于复选框会更新单元格数据，CellDataChanged 也会触发：

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

自定义绘制

覆写 OnContentPaint 以自定义复选框外观：

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

单选按钮，继承自 CheckBoxCell。同组内的单选按钮互相切换。

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

RadioButtonGroup

分配共享的 RadioButtonGroup，使同一时间只能选中一个单选按钮：

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 成员

属性

事件

// Click 事件
radio.Click += (s, e) => { /* 处理 */ };

// 组中所有单选按钮的 CheckChanged 事件
group.RadioButtons.ForEach(rb =>
    rb.CheckChanged += (s, e) =>
        Console.WriteLine("Selected: " + sheet[rb.Cell.Row, rb.Cell.Column + 1]));

DropdownListCell

下拉列表，允许用户从项目列表中选择。

构造函数

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

属性

事件

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

选中项也会设置为单元格数据，因此 CellDataChanged 也会触发。

了解更多请参阅 下拉列表单元格。

ComboListCell

组合框，将文本输入框与下拉选择列表结合。支持输入时自动补全。

构造函数

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

属性

事件

DropdownCell（基类）

DropdownCell 是所有下拉单元格类型的抽象基类。可以扩展它来创建自定义下拉控件。

属性

方法

事件

请参阅 如何创建自定义下拉单元格 了解创建自定义下拉控件。

ProgressCell

显示水平进度条。单元格值（0–1）决定填充量。

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

属性

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

NegativeProgressCell

显示正值和负值的进度条。正值从中心向右延伸；负值从中心向左延伸。

sheet["B2"] = new NegativeProgressCell();
sheet["B2"] = -0.3;  // 30% 负向进度

属性

HyperlinkCell

可点击的超链接。使用单元格数据作为显示文本和导航 URL。

// 点击时自动导航到 URL
sheet[1, 2] = new HyperlinkCell("http://www.google.com", true);

// 或分别设置 URL 和显示文本
sheet[1, 2] = new HyperlinkCell("http://www.google.com", false);
sheet[1, 2] = "Google";

构造函数

属性

事件

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

方法

ImageCell

在单元格中显示图片。

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

构造函数

属性

ImageCellViewMode 枚举

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

通过单元格对齐样式控制图片位置：

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

ImageButtonCell

显示图片的按钮。继承自 ButtonCell。

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

属性

继承 ButtonCell 的 Click 事件和 PerformClick() 方法。

DatePickerCell

带月历的下拉单元格，用于日期选择。仅 WinForms。

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

选择的日期存储为单元格的数据。

注意： DatePickerCell 仅在 WinForms 版本中可用。对于 WPF，请参阅 如何创建日期选择器单元格。

ColumnDropdownListCell

使用列数据作为选择来源的下拉列表。仅 WinForms。

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

单元格主体大小

单元格主体的大小由其父单元格决定，包括任何内边距样式。要使单元格主体更大，可以合并多个单元格：

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

平台可用性

演示项目

内置单元格类型的示例包含在 Demo 项目中。

WinForms：

WPF：

相关主题

• 自定义单元格 — 创建自定义单元格主体
• 下拉列表单元格 — 下拉列表详情
• 如何创建自定义下拉单元格 — 自定义下拉教程
• 如何创建日期选择器单元格 — WPF 日期选择器教程
• 单元格 — 单元格属性和数据