DragEventArgs 類別

  • 參考

定義

命名空間:
Windows.UI.Xaml
編輯

提供拖放事件的數據。

public ref class DragEventArgs sealed : RoutedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DragEventArgs final : RoutedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DragEventArgs : RoutedEventArgs
Public NotInheritable Class DragEventArgs
Inherits RoutedEventArgs
繼承
Object Platform::Object IInspectable RoutedEventArgs DragEventArgs
屬性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

DragEventArgs 會作為這些事件的事件數據：

這些事件是路由事件。 從事件處理程式變更 DragEventArgs 的 Handled 屬性值，可能會影響路由事件的行為。 如需路由事件概念的詳細資訊，請參閱 事件和路由事件概觀。

Control 類別具有預先有線事件處理程式，Control 衍生類型可以覆寫以提供拖放事件的類別型處理，而且這些方法也會使用 DragEventArgs 做為參數。 方法如下：

拖放概念 Windows 執行階段 實作只允許某些控件和輸入動作起始拖放動作。 沒有任何一般化 DoDragDrop 方法允許任何 UI 元素起始拖放動作。 拖放動作的主要來源是當您拖曳列表的專案時，例如 GridView。 對於清單專案拖放動作，事件數據 中的數據值可能會 從控件定義的預設數據修改專案。 這是透過處理 DragItemsStarting 事件，以及處理事件數據中從 DragItemsStartingEventArgs.Data 屬性取得的 DataPackage 物件來完成。

版本歷程記錄

Windows 版本 SDK 版本 新增值
1607 14393 AllowedOperations

屬性

AcceptedOperation

取得或設定值，指定拖曳事件的目標可以接受哪些作業 (無、移動、複製和/或連結) 。
AllowedOperations

取得值，指定拖曳事件來源允許哪些作業 (無、移動、複製和/或連結) 。
Data

取得或設定 dataPackage (DataPackage) ，其中包含與對應拖曳事件相關聯的數據。 這個值在所有事件案例中都無效;具體而言，事件必須由有效的置放目標處理。
DataView

取得 Data 物件的唯讀複本。
DragUIOverride

取得正在拖曳之數據的視覺表示。
Handled

取得或設定值，這個值表示路由事件在傳送路由時之事件處理的目前狀態。
Modifiers

取得旗標列舉型別，表示 SHIFT、CTRL 和 ALT 鍵的目前狀態，以及滑鼠按鍵的狀態。
OriginalSource

取得引發事件之 對象的參考。 這通常是控件的範本部分，而不是在應用程式 UI 中宣告的專案。

(繼承來源 RoutedEventArgs)

方法

GetDeferral()

建立並傳回 DragOperationDeferral 物件，以支援異步拖放作業。
GetPosition(UIElement)

傳回相對於指定 UIElement的置放點。

適用於

另請參閱