Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TileControl.ItemDropped Event

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

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.2.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