TreeView.DragItemsStarting Event
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"/>
| Device family |
Windows 10, version 1809 (introduced in 10.0.17763.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v7.0)
|
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.
| Product | Versions |
|---|---|
| WinRT | Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |