DevExpress&WinForms-TreeList-设置不可编辑

阿蒙Armon

已于 2025-04-29 17:37:17 修改

阅读量242

点赞数

CC 4.0 BY-SA版权

分类专栏： DevExpress 文章标签： c# DevExpress WinForms

于 2025-04-29 15:38:08 首次发布

本文链接：https://blog.youkuaiyun.com/huyu107/article/details/147613021

DevExpress 专栏收录该内容

19 篇文章

订阅专栏

DevExpress TreeList 编辑权限控制：从全局到细粒度设置

在使用 DevExpress TreeList 控件开发数据展示界面时，根据业务需求限制用户编辑行为是常见需求。本文将从全局禁用编辑、列级权限控制、行级动态限制到单元格精准管控，系统讲解 TreeList 编辑权限的多层级设置方法。

一、全局禁用：设置 TreeList 整体不可编辑

当需要完全禁止用户对 TreeList 进行任何编辑操作时，可通过控件级属性快速实现：

操作步骤（设计器方式）

打开 TreeList 设计器
右键控件选择 TreeList Designer，或通过属性面板点击 Columns & Designers 进入。
配置编辑行为选项
在左侧导航栏选择 Options -> OptionsBehavior，将 Editable 属性设置为 False。

代码等价实现

treeList1.OptionsBehavior.Editable = false; // 禁用整个 TreeList 编辑

适用场景：只读展示场景，如数据报表、组织结构图等无需用户交互修改的界面。

二、列级控制：设置特定列不可编辑

若需保留部分列的编辑权限，仅禁止特定列的修改，可通过列属性单独配置：

操作步骤（设计器方式）

选择目标列
在设计器 Columns 面板中，选中需要限制的列（如 Name 列）。
禁用列编辑
在右侧属性面板找到 Column Options -> AllowEdit，设置为 False。

代码动态控制

// 通过列名获取列对象并禁用编辑
var column = treeList1.Columns["Name"];
column.OptionsColumn.AllowEdit = false;

核心属性：Column.OptionsColumn.AllowEdit，支持运行时动态切换（如根据用户权限动态启用/禁用）。

三、行级限制：基于节点特征动态禁止编辑

TreeList 未直接提供行级编辑属性，但可通过 ShowingEditor 事件实现灵活控制。该事件在单元格进入编辑状态前触发，通过 CancelEventArgs 可取消编辑操作。

实现逻辑

private void treeList1_ShowingEditor(object sender, CancelEventArgs e)
{
    var tree = (TreeList)sender;
    var focusedNode = tree.FocusedNode;

    // 场景 1：禁止特定层级的行编辑（如仅允许根节点编辑）
    if (focusedNode.Level == 0) 
    {
        e.Cancel = true; // 根节点不可编辑
        return;
    }

    // 场景 2：通过节点 ID 精准限制（如禁用 ID=1 的行）
    var targetNodeId = 1;
    if (focusedNode["Id"]?.ToString() == targetNodeId.ToString()) 
    {
        e.Cancel = true;
    }

    // 场景 3：结合业务逻辑（如根据节点状态禁用）
    var isReadOnly = (bool)focusedNode["IsReadOnly"];
    if (isReadOnly) 
    {
        e.Cancel = true;
    }
}

事件核心：

FocusedNode：获取当前聚焦的节点
e.Cancel = true：阻止进入编辑模式
支持组合条件（层级+ID+业务状态）实现复杂权限控制

四、单元格粒度：精准控制特定单元格可编辑性

若需对单个单元格进行编辑控制（如某列某行不可编辑），同样通过 ShowingEditor 事件实现，结合列信息判断：

代码实现

private void treeList1_ShowingEditor(object sender, CancelEventArgs e)
{
    var tree = (TreeList)sender;
    var focusedNode = tree.FocusedNode;
    var focusedColumn = tree.FocusedColumn;

    // 场景：禁止「名称」列中二级节点的单元格编辑
    if (focusedColumn.FieldName == "Name" && focusedNode.Level == 1) 
    {
        e.Cancel = true;
        return;
    }

    // 进阶：根据单元格值动态控制（如禁用状态为「已归档」的行）
    var status = focusedNode["Status"]?.ToString();
    if (status == "Archived" && focusedColumn.FieldName == "Value") 
    {
        e.Cancel = true;
    }
}