TreeView.DragItemsStarting 事件
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
發生于起始包含檢視中其中一個專案的拖曳作業時。
適用于 UWP 的對等 WinUI 2 API:Microsoft.UI.Xaml.Controls.TreeView.DragItemsStarting (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來取消拖曳作業。