Share via


TreeView.DragItemsStarting Event

Definition

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.

Applies to

See also