TreeView.DragItemsStarting Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs when a drag operation that involves one of the items in the view is initiated.
Equivalent WinUI 2 API for UWP: Microsoft.UI.Xaml.Controls.TreeView.DragItemsStarting (for WinUI in the Windows App SDK, see the Windows App SDK namespaces).
// Register
event_token DragItemsStarting(TypedEventHandler<TreeView, TreeViewDragItemsStartingEventArgs const&> const& handler) const;
// Revoke with event_token
void DragItemsStarting(event_token const* cookie) const;
// Revoke with event_revoker
TreeView::DragItemsStarting_revoker DragItemsStarting(auto_revoke_t, TypedEventHandler<TreeView, TreeViewDragItemsStartingEventArgs const&> const& handler) const;public event TypedEventHandler<TreeView,TreeViewDragItemsStartingEventArgs> DragItemsStarting;function onDragItemsStarting(eventArgs) { /* Your code */ }
treeView.addEventListener("dragitemsstarting", onDragItemsStarting);
treeView.removeEventListener("dragitemsstarting", onDragItemsStarting);
- or -
treeView.ondragitemsstarting = onDragItemsStarting;Public Custom Event DragItemsStarting As TypedEventHandler(Of TreeView, TreeViewDragItemsStartingEventArgs) <TreeView DragItemsStarting="eventhandler"/>
Event Type
Windows requirements
| Device family |
Windows 10, version 1809 (introduced in 10.0.17763.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v7.0)
|
Remarks
To receive this event, set the CanDragItems property to true.
This event occurs when you start a drag-and-drop operation, including when you perform a reorder operation by drag-and-drop. When you perform custom actions as a result of a drag-and-drop operation, you typically listen to this event and provide more data using the TreeViewDragItemsStartingEventArgs.Data property.
You can inspect the items being dragged by checking the TreeViewDragItemsStartingEventArgs.Items property.
You can cancel the drag operation by setting the TreeViewDragItemsStartingEventArgs.Cancel property to true.