Back to Devexpress

NavBarControl.DragDropFlags Property

windowsforms-devexpress-dot-xtranavbar-dot-navbarcontrol-162ba409.md

latest5.0 KB
Original Source

NavBarControl.DragDropFlags Property

Gets or sets a set of flags controlling the control’s behavior as it relates to link drag and drop operations.

Namespace : DevExpress.XtraNavBar

Assembly : DevExpress.XtraNavBar.v25.2.dll

NuGet Package : DevExpress.Win

Declaration

csharp
[DefaultValue(NavBarDragDrop.AllowDrag | NavBarDragDrop.AllowDrop)]
[XtraSerializableProperty]
public virtual NavBarDragDrop DragDropFlags { get; set; }
vb
<DefaultValue(NavBarDragDrop.AllowDrag Or NavBarDragDrop.AllowDrop)>
<XtraSerializableProperty>
Public Overridable Property DragDropFlags As NavBarDragDrop

Property Value

TypeDefaultDescription
NavBarDragDropAllowDragAllowDrop

A set of NavBarDragDrop enumeration values specifying a link’s drag-and-drop options.

|

Available values:

NameDescription
None

If active, disables all other options. Drag-and-drop operations are prohibited for a control/group in such a case.

| | Default |

If active for a NavBarControl control, enables the AllowDrag and AllowDrop options and disables all others. If active for a group, the group inherits the control’s set of drag-and-drop options.

| | AllowDrag |

If active for a NavBarControl control, its links are allowed to be dragged. If active for a group, a user can drag items of this group.

| | AllowDrop |

If active for a NavBarControl control, links of this control can be dropped onto it. If active for a group, links of the control can be dropped onto this group. Links of other controls cannot be dropped unless the AllowOuterDrop option is active.

| | AllowOuterDrop |

If active for a NavBarControl control, links of other NavBarControl controls can be dropped onto the control. If active for a group, links of other controls can be dropped onto this group. Use the AllowDrop option to specify whether links of this control can be dropped onto the control/group.

|

Remarks

Use the DragDropFlags property to control the NavBarControl‘s behavior as it relates to link drag and drop operations. It allows you to enable or disable automatic link drag and drop actions and dropping them from other NavBarControl controls.

Each group can override the control’s settings concerning links drag and drop. Use the NavBarGroup.DragDropFlags property for this purpose. The desired NavBarGroup object can be obtained via the NavBarControl.Groups property.

Note that the NavBarDragDrop.Default option implies that the NavBarDragDrop.AllowDrag and NavBarDragDrop.AllowDrop options are enabled while other options are disabled. The NavBarControl.GetDragDropFlags method returns the corrected NavBarControl.DragDropFlags property value.

Example

the following sample code uses the NavBarControl.DragDropFlags property to modify the control’s drag and drop options. It prohibits dropping items from the same control and allows you to drop items from other NavBarControl.

csharp
using DevExpress.XtraNavBar;
// ...
navBarControl1.DragDropFlags &= ~NavBarDragDrop.AllowDrop;
navBarControl1.DragDropFlags |= NavBarDragDrop.AllowOuterDrop;
vb
Imports DevExpress.XtraNavBar
' ...
With NavBarControl1
   .DragDropFlags = .DragDropFlags And Not NavBarDragDrop.AllowDrop
   .DragDropFlags = .DragDropFlags Or NavBarDragDrop.AllowOuterDrop
End With

See Also

DragDropFlags

GetDragDropFlags()

NavBarControl Class

NavBarControl Members

DevExpress.XtraNavBar Namespace