Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TreeListOptionsDragAndDrop.DragNodesMode Property

Gets or sets whether single or multiple nodes can be dragged simultaneously, or whether the drag-and-drop functionality is disabled.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v24.2.dll

NuGet Packages: DevExpress.Win.Navigation, DevExpress.Win.TreeList

#Declaration

[DefaultValue(DragNodesMode.None)]
[XtraSerializableProperty]
public virtual DragNodesMode DragNodesMode { get; set; }

#Property Value

Type Default Description
DevExpress.XtraTreeList.DragNodesMode None

Nodes drag-and-drop mode.

#Property Paths

You can access this nested property as listed below:

Object Type Path to DragNodesMode
TreeList
.OptionsDragAndDrop .DragNodesMode

#Remarks

If the DragNodesMode property is set to None, node drag-and-drop is disabled in the current Tree List control. Set the DragNodesMode property to Single or Multiple to enable single or multiple node drag-and-drop. When activating multiple node drag-and-drop, ensure that multiple node selection is enabled (see TreeListOptionsSelection.MultiSelect).

To insert a node prior to another node, by default, an end-user needs to hold the SHIFT key down while dragging. If the TreeListOptionsDragAndDrop.DropNodesMode property is set to Advanced, the SHIFT key needn’t be pressed. To insert a node above another node, an end-user should hover the dragged node over the upper half of the target node. When dragging-and-dropping over the lower half of the target node, the dragged node will be inserted as a child of the target node.

To copy the dragged node (instead of a move operation), hold the CTRL key down. Nodes can be copied only if the TreeListOptionsDragAndDrop.CanCloneNodesOnDrop option is set to true.

See Also