New to Telerik UI for WPFStart a free 30-day trial

The base class for drag-drop operation behaviors.

Definition

Namespace:Telerik.Windows.DragDrop.Behaviors

Assembly:Telerik.Windows.Controls.dll

Type Parameters:

TState

Syntax:

C#
public interface IDragDropBehavior<TState>

Derived Classes: DragDropBehavior<TState>FileBrowserDragDropBehaviorTaskBoardColumnDragDropBehaviorDragDropBehavior<TState>GridViewDragDropBehaviorListBoxDragDropBehavior...

Methods

Gets the value specifying whether the drag operation can be completed, or not.

C#
bool CanDrop(TState state)
Parameters:stateTState

DragDropState identifying the current drag operation.

Returns:

bool

True when the drag operation can be finished, otherwise false.

Remarks:

This method is called on every mouse move. All properties in the DragDropState are valid.

Gets the value specifying whether the drag operation can be started, or not.

C#
bool CanStartDrag(TState state)
Parameters:stateTState

DragDropState that provides context for the current operation.

Returns:

bool

True when the drag operation can be started, otherwise false.

Remarks:

This method is called only when the drag operation initiated.

When overridden in a derived class, filters the dragged items collection if necessary.

C#
IEnumerable CoerceDraggedItems(TState state)
Parameters:stateTState

DragDropState that provides context for the current operation.

Returns:

IEnumerable

The filtered dragged items.

Remarks:

This method is called immediately before the drag operation starts. Only the Items property of the DragDropState is valid.

When overridden in a derived class cleans up a cancelled drag operation. This method is called only in the context of the drag source control.

C#
void DragDropCanceled(TState state)
Parameters:stateTState

DragDropState that provides context for the current operation.

Remarks:

This method is called only when the drag operation is cancelled by the user. If this method is called, the source's DragDropCompleted and target's Drop methods are not called.

When overridden in a derived class completes the drag operation. This method is called only in the context of the drag source control.

C#
void DragDropCompleted(TState state)
Parameters:stateTState

DragDropState that provides context for the current operation.

Remarks:

When the drag source and the drop target are the same control, this method is called after Drop. This method is called only when the drag operation completed successfully. If this method is called, DragDropCanceled is not called.

When overridden in a derived class completes the drop operation. This method is called only in the context of the drop target control.

C#
void Drop(TState state)
Parameters:stateTState

DragDropState that provides context for the current operation.

Remarks:

When the drag source and the drop target are the same control, this method is called before DragCompleted.