DragDropManager.QueryDragPreviewImage Event

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

Namespace: DevExpress.Utils.DragDrop

Assembly: DevExpress.Utils.v24.1.dll

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

Declaration

C#

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

VB.NET

<DXCategory("DragDrop")>
Public Event QueryDragPreviewImage As QueryDragPreviewImageEventHandler

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:

• the PreviewImage event argument in a DragDropManager.QueryDragPreviewImage event handler

• the PreviewImage event argument in a DragDropEvents.BeginDragDrop event handler