windowsforms-devexpress-dot-utils-dot-dragdrop-dot-dragdropmanager.md
Allows you to provide a preview of the dragged data elements.
Namespace : DevExpress.Utils.DragDrop
Assembly : DevExpress.Utils.v25.2.dll
NuGet Packages : DevExpress.Utils, DevExpress.Wpf.Core
[DXCategory("DragDrop")]
public event QueryDragPreviewImageEventHandler QueryDragPreviewImage
<DXCategory("DragDrop")>
Public Event QueryDragPreviewImage As QueryDragPreviewImageEventHandler
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. |
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:
the PreviewImage event argument in a DragDropManager.QueryDragPreviewImage event handler
the PreviewImage event argument in a DragDropEvents.BeginDragDrop event handler
See Also