Freigeben über


TreeView.DragItemsStarting Ereignis

Definition

Tritt auf, wenn ein Ziehvorgang, der eines der Elemente in der Ansicht umfasst, initiiert wird.

Entsprechende WinUI 2-API für UWP: Microsoft.UI.Xaml.Controls.TreeView.DragItemsStarting (Informationen zu WinUI in der Windows App SDK finden Sie im 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"/>

Ereignistyp

Windows-Anforderungen

Gerätefamilie
Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v7.0)

Hinweise

Um dieses Ereignis zu empfangen, legen Sie die CanDragItems-Eigenschaft auf true fest.

Dieses Ereignis tritt auf, wenn Sie einen Drag-and-Drop-Vorgang starten, einschließlich, wenn Sie einen Neuanordnungsvorgang durch Ziehen und Ablegen ausführen. Wenn Sie als Ergebnis eines Drag-and-Drop-Vorgangs benutzerdefinierte Aktionen ausführen, lauschen Sie in der Regel auf dieses Ereignis und stellen mithilfe der TreeViewDragItemsStartingEventArgs.Data-Eigenschaft weitere Daten bereit.

Sie können die gezogenen Elemente überprüfen, indem Sie die TreeViewDragItemsStartingEventArgs.Items-Eigenschaft überprüfen.

Sie können den Ziehvorgang abbrechen, indem Sie die TreeViewDragItemsStartingEventArgs.Cancel-Eigenschaft auf true festlegen.

Gilt für:

Weitere Informationen