TreeView.DragItemsStarting Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.