StandaloneGallery.DragItemStart Event

Fires when a drag-and-drop operation starts on a gallery item. Allows you to cancel the operation.

Namespace: DevExpress.XtraBars.Ribbon.Gallery

Assembly: DevExpress.XtraBars.v24.2.dll

Declaration

C#

[DXCategory("Events")]
public event GalleryDragItemStartEventHandler DragItemStart

VB.NET

<DXCategory("Events")>
Public Event DragItemStart As GalleryDragItemStartEventHandler

Event Data

The DragItemStart event's data class is DevExpress.XtraBars.Ribbon.Gallery.GalleryDragItemStartEventArgs.

Remarks

The StandaloneGallery provides you with events that allow you to manage a drag-and-drop operation during all of its stages: the operation on an item is started, the item is being dragged, and the item has been dropped. The events below correspond to each stage of a drag-and-drop operation:

• The DragItemStart event — fires when an end-user starts a drag-and-drop operation, and allows you to cancel the action. For this purpose, set the Cancel event argument to true. If this event is canceled, the subsequent StandaloneGallery.DragItemMove and StandaloneGallery.DragItemDrop events do not fire.
• The StandaloneGallery.DragItemMove event — fires during the mouse generating event. During this stage, the item image is displayed near the mouse cursor.
• The StandaloneGallery.DragItemDrop event — fires when the item has been dropped, and allows you to perform custom actions.

At all stages of the drag-and-drop operation, you can get access to the item being dragged using the Item event argument.