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 运行时实现仅允许某些控件和输入操作启动拖放操作。 没有允许任何 UI 元素启动拖放操作的通用 化 DoDragDrop 方法。 拖放操作main源是拖动列表（如 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 的放置点。

适用于

另请参阅