Skip to main content

TcxDragDropSettings.DropEffect Property

Specifies the action(s) to be performed after a shell item has been dragged and dropped from a shell control.

Declaration

property DropEffect: TcxDropEffectSet read; write; default [deCopy, deMove, deLink];

Property Value

Type
TcxDropEffectSet

Remarks

Set DropEffect flag value(s) to allow one or more actions to be performed on the completion of a drag-and-drop operation initiated by a shell control. Available flag values include:

Value Meaning
deCopy Drop results in a copy. The original data (shell item) remains unmodified by the drag source.
deMove Drag source should remove the original data (shell item).
deLink Drag source should create a link to the original data (shell item).

The resulting action to be performed is determined by the key(s) that an end-user holds down during the drop operation:

  • Dropping an item while holding down the Ctrl key will copy this item;

  • Dropping an item while holding down the Shift key will move this item;

  • Dropping an item while holding down the Ctrl+Shift key combination will create a link to this item.

If none of these keys were held down during the operation, then the resulting action is specified by the target shell control’s DefaultDropEffect property. Note that if the value of this property does not have a matching flag value set in the source shell control’s DropEffect property, the drop operation will fail to complete, as the target shell control will not accept it.

The default value of the DropEffect property is [deCopy, deMove, deLink].

See Also