Skip to main content

TileControl.ItemDropped Event

Occurs after a tile that was dragged at runtime lands on its final position.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DXCategory("Behavior")]
public event TileItemDropEventHandler ItemDropped

Event Data

The ItemDropped event's data class is DevExpress.XtraEditors.TileItemDropEventArgs.

Remarks

With default TileControl settings, end-users are able to drag tiles at runtime. This fires three related events.

  • TileControl.StartItemDragging - a cancelable event that allows you to check what tile is being dragged and identify its parent tile group.
  • TileControl.EndItemDragging - another cancelable event fires immediately after a dragged tile was released. By handling this event, you can prevent the specific drag operation without disabling the capability to drag tiles on the TileControl level.
  • ItemDropped - the event that occurs when a tile lands on its final location, be it the location chosen by an end-user or tile original position in case dragging was cancelled with the TileControl.EndItemDragging event. The event provides the e.ItemDraggingCanceled read-only property to identify which of these two scenarios did actually happen to your tile.

To disable dragging tiles at runtime, set the TileControl.AllowDrag property to false.

See Also