New to Telerik UI for WPF? Download free 30-day trial

DragDropMode

With the official Q1 2013 release of UI for WPF we introduced a new DragDrop mode for the Docking control which enables dragging and dropping panes without being able to leave them floating.

This behavior can be turned on with the new DragDropMode property which is of Enum type and can be set to any of the following values:

  • Immediate - the default DragDrop behavior.

  • Deferred - provides a completely different way of handling the drag and drop inside RadDocking. With it you can forbid floating of panes and at the same time allow dragging them.

The following snippets show how DragDropMode property can be set in XAML and in code-behind:

<telerik:RadDocking x:Name="radDocking" DragDropMode="Deferred"> 
    ... 
</telerik:RadDocking> 

radDocking.DragDropMode = DockingDragDropMode.Deferred; 

Let's, for example, have the following RadDocking definition:

<telerik:RadDocking x:Name="radDocking1"> 
    <telerik:RadSplitContainer> 
        <telerik:RadPaneGroup> 
            <telerik:RadPane Header="Pane1" > 
            </telerik:RadPane> 
            <telerik:RadPane Header="Pane2" CanFloat="False" /> 
        </telerik:RadPaneGroup> 
    </telerik:RadSplitContainer> 
</telerik:RadDocking> 

Note how the dragging of "Pane1" looks in both DragDropModes:

docking features-dragdropmode 1

In the second case ( DragDropMode="Deferred"), "Pane1" can be made floating only through the ContextMenu:

docking features-dragdropmode 2

In "Deferred" DragDropMode if the pane is dropped in the Docking space, it will return to its previous position.

As to "Pane2" which has CanFloat property set to False - in "Immediate" DragDropMode the pane cannot be dragged at all while in "Deferred" it can be dragged and docked using the Compass. However, in both DragDropModes "Floating" option in the ContextMenu is disabled:docking features-dragdropmode 3

In "Deffered" DragDropMode you will be able to drop a RadPane/RadPaneGroup between two RadPanes in a RadPaneGroup (AllowDragReorder property is disregarded in this mode).

In this article