DXP TreeList 目录树

1.需求背景

需要一个支持勾选，拖动节点，保存各节点顺序的目录树。

2.创建目录树

在treeList控件中添加两个colunm 用来显示绑定数据和显示值。

接下来对treeList的属性进行设置

            // 设置列不显示             treeList.OptionsView.ShowColumns = false;             // 设置序号列不显示             treeList.OptionsView.ShowIndicator = false;             // 设置垂直线不显示             treeList.OptionsView.ShowVertLines = false;             // 设置水平线不显示             treeList.OptionsView.ShowHorzLines = false;             // 设置焦点框为行焦点             treeList.OptionsView.FocusRectStyle = DevExpress.XtraTreeList.DrawFocusRectStyle.RowFocus;             // 隐藏第一列(数据列)             treeListColumn1.Visible = false;             // 设置不可编辑             treeList.OptionsBehavior.Editable = false;             // 设置显示复选框             treeList.OptionsView.ShowCheckBoxes = true;             // 设置勾选父节点，子节点自动全选             treeList.OptionsBehavior.AllowRecursiveNodeChecking = true;   

添加节点

        private TreeListNode AppendNode(PrjTableNode node, int pid)         {             TreeListNode treeListNode = null;             Action<PrjTableNode, int> ac = (arg1, arg2) =>              {                  treeListNode = treeList.AppendNode(new object[] { node, node.Alias }, pid, 0, 0, 0);              };             var tt = treeList.Invoke(ac, new object[] { node, pid });             SetNodeCheckState(treeListNode);             return treeListNode;         } 

主要用到treeList.AppendNode()方法，方法定义如下

 AppendNode(object nodeData, int parentNodeId, int imageIndex, int selectImageIndex, int stateImageIndex) 

• nodeData : object 类型的参数，这里传入object[]数组对象，数组对应treeList的列，这里第一列是数据，第二列用来显示，因此需要将第一列隐藏。
• parentNodeId ：父节点ID
• imageIndex ： 节点图标索引，这里没有图标就给任意一个数字
• selectImageIndex ： 节点被选择后显示的图标索引
• stateImageIndex ： 状态图标索引

此时目录树就创建好了。

2.1 设置目录树选中节点的背景色

添加CustomDrawNodeCell事件

            // 设置行背景色             treeList.CustomDrawNodeCell -= TreeList_CustomDrawNodeCell;             treeList.CustomDrawNodeCell += TreeList_CustomDrawNodeCell; 

设置颜色

        private void TreeList_CustomDrawNodeCell(object sender, DevExpress.XtraTreeList.CustomDrawNodeCellEventArgs e)         {             if (e.Node.Selected)             {                 e.Appearance.BackColor = Color.FromArgb(192, 192, 255);             }         } 

2.2 控制目录树节点的勾选框是否显示

添加CustomDrawNodeCheckBox事件

            // 控制复选框显隐             treeList.CustomDrawNodeCheckBox -= TreeList_CustomDrawNodeCheckBox;             treeList.CustomDrawNodeCheckBox += TreeList_CustomDrawNodeCheckBox; 

        private void TreeList_CustomDrawNodeCheckBox(object sender, DevExpress.XtraTreeList.CustomDrawNodeCheckBoxEventArgs e)         {             // 满足逻辑条件的 ，将 e.Handled = true 即可             if ((e.Node.GetValue(treeListColumn1) as PrjTableNode)?.Type == ConstClass1.PRJ_TYPE_ID)             {                 //e.Handled = true;             }         } 

2.3 节点拖拽

这里的需求是只允许同级节点内部拖动，也不允许拖动到节点子集。

设置属性OptionsDragAndDrop.DragNodesMode = DragNodesMode.Single

添加DragOver,DragDrop，AfterDragNode事件

            // 设置节点拖拽             treeList.OptionsDragAndDrop.DragNodesMode = DragNodesMode.Single; 		   // 处理拖动时的逻辑              treeList.DragOver -= TreeList_DragOver;             treeList.DragOver += TreeList_DragOver; 		   // 处理拖动结束时的逻辑              treeList.DragDrop -= TreeList_DragDrop;             treeList.DragDrop += TreeList_DragDrop; 		   // 处理拖动后的逻辑              treeList.AfterDragNode -= TreeList_AfterDragNode;             treeList.AfterDragNode += TreeList_AfterDragNode; 

DragOver 用来处理拖动时的逻辑

当有节点需要禁止拖动时，满足逻辑时，设置 e.Effect = DragDropEffects.None;即可

       private void TreeList_DragOver(object sender, DragEventArgs e)         {             var currNode = treeList.FocusedNode;             var curNodeData = currNode.GetValue(treeListColumn1) as PrjTableNode;             if (curNodeData == null)             {                 return;             }             if (!curNodeData.CanDrag)             {                 e.Effect = DragDropEffects.None;             }         } 

DragDrop 用来处理拖动结束时的逻辑

        private void TreeList_DragDrop(object sender, DragEventArgs e)         {             // 当前节点的父节点变化，则不允许拖动             var dragNode = e.Data.GetData(typeof(TreeListNode)) as TreeListNode;             var sourceParent = dragNode.ParentNode.GetValue(treeListColumn1) as PrjTableNode;              var targetNode = treeList.CalcHitInfo(treeList.PointToClient(MousePosition)).Node;             if (targetNode == null)             {                 return;             }             PrjTableNode targetNodeParent = null;             if (targetNode.ParentNode != null)             {                 targetNodeParent = targetNode.ParentNode.GetValue(treeListColumn1) as PrjTableNode;             }             // 发生跨级移动             if (sourceParent.Id != targetNodeParent.Id)             {                 e.Effect = DragDropEffects.None;                 return;             }             // 移到子集             if (AjustDirection(sender, e) == DragInsertPosition.AsChild)             {                 e.Effect = DragDropEffects.None;                 return;             }         } 

        /// <summary>         /// 移动过程中的方向         /// </summary>         /// <param name="sender"></param>         /// <param name="e"></param>         /// <returns></returns>         private DragInsertPosition AjustDirection(object sender, DragEventArgs e)         {             var tl = sender as TreeList;             //var dragNode = e.Data.GetData(typeof(TreeListNode)) as TreeListNode;             //var hit = tl.CalcHitInfo(tl.PointToClient(new Point(e.X, e.Y)));             var pi = typeof(TreeList).GetProperty("Handler", BindingFlags.Instance | BindingFlags.NonPublic);             var handler = (TreeListHandler)pi.GetValue(tl, null);             return handler.StateData.DragInfo.DragInsertPosition;          } 

AfterDragNode 用来处理拖动结束后的逻辑

        private void TreeList_AfterDragNode(object sender, AfterDragNodeEventArgs e)         {             // TODO:...          } 

3.总结

treeList是一个很强大的控件，用来处理树状结构。本次需求中，处理节点拖拽话费了较长时间，也网上找了很多博文，但是都没有直接解决我的问题，因此在这里做个笔记。

后记：纸上得来终觉浅，绝知此事要躬行