DragDropManager.PreviewShowMode Property
Gets or sets whether a preview of dragged data elements is displayed near the mouse pointer during drag-and-drop operations.
Namespace: DevExpress.Utils.DragDrop
Assembly: DevExpress.Utils.v24.1.dll
NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core
Declaration
[DefaultValue(PreviewImageShowMode.Always)]
[DXCategory("Customization")]
public PreviewImageShowMode PreviewShowMode { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| PreviewImageShowMode | Always | A PreviewImageShowMode enumeration values that specifies whether to show a preview of dragged elements. |
Available values:
| Name | Description |
|---|---|
| Never | A preview of the dragged data element is never displayed. |
| Always | A preview of the dragged data element is always displayed. |
| ForDragDropTargets | A preview of the dragged data element is only displayed when a user drag it over 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