dotNet.ReoGrid 扩展库 - 单元格编辑

单元格可以通过以下方式进入编辑模式：

用户双击单元格（默认行为）
按下 F2 键

进入编辑模式后，控件上会显示一个文本框用于接收用户输入。

编辑界面示例：样式化电子表格

检查编辑状态

使用 IsEditing 方法可以检查单元格是否处于编辑模式。

// 检查当前是否有单元格正在编辑
var isEditing = sheet1.IsEditing;

使用 GetEditingCell 方法可以获取当前编辑单元格的位置：

// 获取当前编辑的单元格
var editingCell = sheet1.GetEditingCell();

编辑控制

启动单元格编辑

可以通过编程方式使用 StartEdit 方法启动特定单元格的编辑。该方法支持通过行列索引或 ReoGrid.CellPosition 对象指定单元格：

// 通过行列索引启动编辑（注意 aardio 中行列索引从1开始）
sheet1.StartEdit(3, 4);  // 开始编辑第4列第3行的单元格

// 通过 A1 表示法启动编辑
sheet1.StartEdit(ReoGrid.CellPosition("A1"));  // 开始编辑 A1 单元格

注意：如果已有单元格处于编辑状态时调用新的 StartEdit 命令，当前编辑操作会自动结束，然后开始新的编辑会话。

强制结束单元格编辑

EndEdit 方法可以强制终止当前单元格的编辑操作。它接受一个 ReoGridEndEditReason 参数，用于指定编辑结束后的行为。例如，指定 ReoGridEndEditReason.Cancel 会放弃所有编辑修改，恢复单元格的原始内容。

// 强制结束当前编辑并取消修改
sheet1.EndEdit(ReoGrid.ReoGridEndEditReason.Cancel);

EndEdit 方法还可以直接设置单元格的新值：

// 结束编辑并设置新值
sheet1.EndEdit("新值");

// 结束编辑、设置新值并指定结束原因
sheet1.EndEdit("新值", ReoGrid.ReoGridEndEditReason.Normal);

只读单元格

通过设置单元格的 Readonly 属性可以禁用编辑和粘贴操作：

// 设置 A1 单元格为只读
var cell = sheet1.Cells["A1"];
cell.Readonly = true;

处理单元格编辑事件

ReoGrid 提供了一系列事件来处理单元格编辑过程，不仅可以捕获输入的字符，还可以修改输入的值。

编辑流程示意图： 150

编辑前事件

当用户通过 F2 键或输入字符（包括通过输入法工具输入）启动编辑时，ReoGrid 会触发 BeforeCellEdit 事件。通过设置事件的 IsCancelled 参数可以取消编辑操作。

阻止单元格编辑

通过处理 BeforeCellEdit 事件可以阻止单元格进入编辑模式：

// 订阅 BeforeCellEdit 事件
sheet1.BeforeCellEdit = function(sender, e) {
    // 阻止编辑
    e.IsCancelled = true;
}

编辑中事件

CellEditTextChanging：当单元格文本发生变化时触发，适用于验证或替换整个文本
CellEditCharInputted：当每个字符输入时触发（包括输入法输入的字符）

注意：在 WPF 版本中，CellEditCharInputted 事件不能修改字符，如需修改文本应使用 CellEditTextChanging 事件。

编辑后事件

编辑会话在以下情况结束：

用户按下 Enter 键
输入框失去焦点

此时会触发 AfterCellEdit 和 CellDataChanged 事件。如果按下 Escape 键取消编辑，只会触发 AfterCellEdit 事件。

示例：转换输入数据

通过处理编辑事件可以实现实时验证和转换用户输入：

// 处理文本变化事件
sheet1.CellEditTextChanging = function(sender, e) {
    // 检查输入文本
    if (e.NewText == "特定输入") {
        // 替换为预设数据
        e.NewText = "预设数据";
    }
}

AfterCellEdit 与 CellDataChanged 的区别

AfterCellEdit：提供最后一次取消编辑的机会，可以恢复单元格原始状态
CellDataChanged：在单元格数据发生变化时触发（包括编程修改和粘贴操作）

// 处理编辑后事件
sheet1.AfterCellEdit = function(sender, e) {
    // 可以在这里取消编辑
    if (shouldCancel) {
        e.IsCancelled = true;
    }
}

// 处理数据变化事件
sheet1.CellDataChanged = function(sender, e) {
    // 数据已发生变化
    console.log("单元格数据已更改:", e.Cell.Data);
}

Markdown 格式