当前位置：首页 > article >正文

Node Checking - Checkboxes and Radio Buttons 节点检查 - 复选框和单选按钮

article 2024/10/22 23:18:19

Goto Nodes 节点

Node Checking - Checkboxes and Radio Buttons 节点检查 - 复选框和单选按钮

要选择节点，请使用节点检查功能，该功能为树级别启用内置复选框或单选按钮。在绑定模式下，您可以将节点检查状态与数据库字段同步。本文档详细介绍了此主题。

Enable Checkboxes/Radio Buttons 启用复选框/单选按钮

显示所有节点的复选框/单选按钮

将 TreeListOptionsView.CheckBoxStyle 属性设置为 Check 或 Radio。

在这里插入图片描述

treeList1.OptionsView.CheckBoxStyle = DefaultNodeCheckBoxStyle.Check;
//or
treeList1.OptionsView.CheckBoxStyle = DefaultNodeCheckBoxStyle.Radio;

TreeListOptionsView.CheckBoxStyle 属性指定所有 TreeList 节点的默认复选框显示模式。您可以覆盖根节点和任何节点的子节点的此设置，如下所示。

仅显示根节点的复选框/单选按钮

将 TreeListOptionsView.RootCheckBoxStyle 属性设置为 Check 或 Radio。将 TreeListOptionsView.CheckBoxStyle 属性设置为 Default。

在这里插入图片描述

treeList1.OptionsView.RootCheckBoxStyle = NodeCheckBoxStyle.Check;
treeList1.OptionsView.CheckBoxStyle = DefaultNodeCheckBoxStyle.Default;
//or
treeList1.OptionsView.RootCheckBoxStyle = NodeCheckBoxStyle.Radio;
treeList1.OptionsView.CheckBoxStyle = DefaultNodeCheckBoxStyle.Default;

显示除根节点之外的所有节点的复选框/单选按钮

将 TreeListOptionsView.CheckBoxStyle 设置为 Check/Radio，并将 TreeListOptionsView.RootCheckBoxStyle 设置为 None。

在这里插入图片描述

treeList1.OptionsView.CheckBoxStyle = DefaultNodeCheckBoxStyle.Check;
treeList1.OptionsView.RootCheckBoxStyle = NodeCheckBoxStyle.None;
//or
treeList1.OptionsView.CheckBoxStyle = DefaultNodeCheckBoxStyle.Radio;
treeList1.OptionsView.RootCheckBoxStyle = NodeCheckBoxStyle.None;

显示/隐藏特定节点的子节点的复选框/单选按钮

使用节点的 TreeListNode.ChildrenCheckBoxStyle 属性。此属性将覆盖指定节点的子节点的 TreeListOptionsView.CheckBoxStyle 设置。

在这里插入图片描述

treeList1.OptionsView.CheckBoxStyle = DefaultNodeCheckBoxStyle.Check;
treeList1.OptionsView.RootCheckBoxStyle = NodeCheckBoxStyle.None;
TreeListNode node1 = treeList1.FindNodeByFieldValue("DEPARTMENT", "Sales and Marketing");
node1.ChildrenCheckBoxStyle = DevExpress.XtraTreeList.NodeCheckBoxStyle.Radio;

Related API 相关 API

TreeListOptionsView.CheckBoxStyle - 获取或设置所有 TreeList 节点是否应显示复选框、单选按钮，或者两者都不显示。
TreeListOptionsView.RootCheckBoxStyle - 获取或设置根 TreeList 节点是应绘制复选框、单选按钮，还是两者都不绘制。
TreeListNode.ChildrenCheckBoxStyle - 获取或设置此节点拥有的所有子节点是否应显示复选框和单选按钮，或者两者都不显示。

Indeterminate Check State 不确定检查状态

常规复选框允许最终用户在 Checked 和 Unchecked 状态之间切换。如果启用 TreeListOptionsBehavior.AllowIndeterminateCheckState 属性，则 TreeList 节点将支持三种检查状态（Unchecked、Indeterminate 和 Checked）。按顺序单击复选框可在这些状态之间切换。

Related API 相关 API

TreeListOptionsBehavior.AllowIndeterminateCheckState - 获取或设置最终用户是否可以通过单击鼠标将节点切换到不确定检查状态。

Get Nodes with Checked/Unchecked/Indeterminate States 获取具有 Checked/Unchecked/Indeterminate 状态的节点

要检索所有选中的节点，请使用 TreeList.GetAllCheckedNodes 方法。

以下代码演示如何使用 TreeList.GetAllCheckedNodes 方法检索选中的节点，并修改其值。

List<TreeListNode> list = treeList1.GetAllCheckedNodes();
foreach (TreeListNode node in list) {
    decimal budget = Convert.ToDecimal(node["BUDGET"])*1.1m;
    node["BUDGET"] = budget;
}

您可以使用节点迭代器以递归方式检索与特定条件匹配的节点（例如，未选中的节点或具有不确定状态的节点）。

以下示例说明如何使用节点迭代器检索未选中的 TreeList 节点。

using DevExpress.XtraTreeList.Nodes.Operations;

GetUncheckedNodesOperation op = new GetUncheckedNodesOperation();
treeList1.NodesIterator.DoOperation(op);
//Get the number of unchecked nodes:
int count = op.TargetNodes.Count;

//The operation class that collects unchecked nodes
class GetUncheckedNodesOperation : TreeListOperation {
    public List<TreeListNode> TargetNodes = new List<TreeListNode>();
    public GetUncheckedNodesOperation() : base() { }
    public override void Execute(TreeListNode node) {
        if (node.CheckState == CheckState.Unchecked)
            TargetNodes.Add(node);
    }
}

Obtain and Set Node Check States. Recursive Checking. 获取并设置节点检查状态。递归检查。

使用以下成员在代码中指定节点检查状态。

TreeListNode.Checked - 允许您在启用两种检查状态（Checked 和 Unchecked）时获取/设置节点的检查状态
TreeListNode.CheckState - 允许您在启用三种检查状态（Checked、Indeterminate 和 Unchecked）时获取/设置节点的检查状态
TreeList.SetNodeCheckState - 允许您以递归和非递归方式设置节点的检查状态。
TreeList.CheckAll， TreeListNode.CheckAll， TreeList.UncheckAll， TreeListNode.UncheckAll - 允许您检查和取消选中属于此 TreeListControl 或特定父节点的所有节点的方法。

Recursive Checking 递归检查

要在最终用户切换父节点的检查状态时检查/取消选中子节点（反之亦然），请使用 TreeListOptionsBehavior.AllowRecursiveNodeChecking 属性。

Example 例

TreeListNode node1 = treeList1.FindNodeByFieldValue("DEPARTMENT", "Sales and Marketing");
if (node1 != null)
    treeList1.SetNodeCheckState(node1, CheckState.Checked, false);