TreeView.DragItemsStarting 事件
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在启动涉及视图中的某个项的拖动操作时发生。
适用于 UWP 的等效 WinUI 2 API：Microsoft.UI.Xaml.Controls.TreeView.DragItems 启动Windows 应用 SDK中的 WinUI (，请参阅Windows 应用 SDK命名空间) 。
// 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"/>
事件类型
Windows 要求
| 设备系列 |
Windows 10, version 1809 (在 10.0.17763.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v7.0 中引入)
|
注解
若要接收此事件，请将 CanDragItems 属性设置为 true。
启动拖放操作时发生此事件，包括通过拖放执行重新排序操作时。 由于拖放操作而执行自定义操作时，通常会侦听此事件并使用 TreeViewDragItemsStartingEventArgs.Data 属性提供更多数据。
可以通过检查 TreeViewDragItemsStartingEventArgs.Items 属性来检查正在拖动的项目。
可以通过将 TreeViewDragItemsStartingEventArgs.Cancel 属性设置为 true 来取消拖动操作。