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

DragDropManager.QueryDragPreviewImage Event

Allows you to provide a preview of the dragged data elements.

Namespace: DevExpress.Utils.DragDrop

Assembly: DevExpress.Utils.v24.2.dll

NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

#Declaration

[DXCategory("DragDrop")]
public event QueryDragPreviewImageEventHandler QueryDragPreviewImage

#Event Data

The QueryDragPreviewImage event's data class is QueryDragPreviewImageEventArgs. The following properties provide information specific to this event:

Property Description
Action Gets the drag-and-drop action (Copy, Move, etc.) to perform.
InsertType Gets or sets whether dragged data elements will be inserted before or after data element under the mouse pointer, or as a child (for tree list only).
KeyState Gets the pressed mouse buttons (left, middle, right) and modifier keys (Shift, Ctrl, Alt).
PreviewImage Gets or sets a preview of dragged data elements (rows/nodes/items).
Regions
Source Gets the source control.
Target Gets the target control.

#Remarks

During a drag-and-drop operation, the Behavior Manager shows a preview of dragged data elements near the mouse pointer. You can use the DragDropManager.PreviewShowMode property to disable the preview image or enable it for target controls only.

If this setting is enabled, you can disable a particular control’s preview with the DragDropBehavior.Properties.PreviewVisible property.

To customize the preview image, use the following options:

See Also