Back to Devexpress

TileControl.ItemDropped Event

windowsforms-devexpress-dot-xtraeditors-dot-tilecontrol-5a8fe187.md

latest2.6 KB
Original Source

TileControl.ItemDropped Event

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

Namespace : DevExpress.XtraEditors

Assembly : DevExpress.XtraEditors.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
[DXCategory("Behavior")]
public event TileItemDropEventHandler ItemDropped
vb
<DXCategory("Behavior")>
Public Event ItemDropped As TileItemDropEventHandler

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

StartItemDragging

EndItemDragging

AllowDrag

TileControl Class

TileControl Members

DevExpress.XtraEditors Namespace