BarAndDockingController.DragCursors Property

Gets an array of cursors that can be used for drag operations on links.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

C#

[Browsable(false)]
public virtual ArrayList DragCursors { get; }

VB.NET

<Browsable(False)>
Public Overridable ReadOnly Property DragCursors As ArrayList

Property Value

Type	Description
ArrayList	An ArrayList of Cursor objects.

Remarks

If a bar’s BarOptions.DisableCustomization property is set to false, an end-user can customize links within the bar (move and copy between bars, add from the Customization Window, resize edit links) using drag-and-drop operations. This functionality is enabled if the Customization Window is opened or if the ALT key is pressed while dragging links.

The DragCursors property specifies an array of cursors for different states of drag-and-drop operations. The default images are presented in the following table. You can replace any image if the default one does not suit your needs.

Element Index	Image	Description
0		Indicates that the link being dragged can be dropped at the current position
1		Indicates that a copy of the link will be created if it is dropped at the current position. The user can press the CTRL key while dragging links to copy them instead of moving them to a new position.
2		Indicates that the link cannot be dropped.
3		Indicates that the link can be resized.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DragCursors property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-a-custom-bar-with-to-block-dragging-of-its-items-to-another-bar-e2457/CS/BarsCustomization/MyBarLinkDragManager.cs#L55

{
    Cursor.Current = (Cursor)Manager.GetController().DragCursors[2];
    Manager.SelectionInfo.DropSelectStyle = LinkDropTargetEnum.None;

VB.NET

how-to-create-a-custom-bar-with-to-block-dragging-of-its-items-to-another-bar-e2457/VB/BarsCustomization/MyBarLinkDragManager.vb#L55

If TypeOf DragObject Is BarItemLink AndAlso IsItemLinkIsFixed(CType(DragObject, BarItemLink)) Then
    Cursor.Current = CType(Manager.GetController().DragCursors(2), Cursor)
    Manager.SelectionInfo.DropSelectStyle = LinkDropTargetEnum.None