Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxDragDropSettings.DropEffect Property

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

#Declaration

Delphi
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