DragEventArgs 类

定义

提供拖放事件的数据。

public ref class DragEventArgs sealed : RoutedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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
属性

注解

DragEventArgs 用作以下事件的事件数据:

这些事件是路由事件。 从事件处理程序更改 的 DragEventArgsHandled 属性的值可能会影响路由事件的行为方式。 有关路由事件概念的详细信息,请参阅 事件和路由事件概述

Control 类具有预先连接的事件处理程序,Control 派生类型可以重写这些处理程序,以便为拖放事件提供基于类的处理,并且这些方法也用作DragEventArgs参数。 这些方法包括:

拖放概念Windows 运行时实现仅允许某些控件和输入操作启动拖放操作。 没有允许任何 UI 元素启动拖放操作的通用方法 DoDragDrop 。 拖放操作main源是拖动列表(如 GridView)的项目时。 对于列表项拖放操作,可能会从控件定义的有关项的默认数据修改事件数据中的数据值。 这是通过处理 DragItemsStarting 事件,并使用从事件数据中的 DragItemsStartingEventArgs.Data 属性获取的 DataPackage 对象来完成的。

属性

AcceptedOperation

获取或设置一个值,该值指定拖动事件的目标可以接受哪些 (无、移动、复制和/或链接) 的操作。

AllowedOperations

获取一个值,该值指定拖动事件的源允许哪些操作 (无、移动、复制和/或链接) 。

Data

获取或设置 DataPackage (dataPackage) 的数据对象,该对象包含与相应拖动事件关联的数据。 此值并非在所有事件情况下都有用;具体而言,事件必须由有效的删除目标处理。

DataView

获取 Data 对象的只读副本。

DragUIOverride

获取要拖动的数据的可视表示形式。

Handled

获取或设置一个值,该值指示针对路由事件(在其经过路由时)的事件处理的当前状态。

Modifiers

获取一个标志枚举,指示 Shift、Ctrl 和 Alt 键的当前状态以及鼠标按钮的状态。

OriginalSource

获取对引发事件的 对象的引用。 这通常是控件的模板部分,而不是在应用 UI 中声明的元素。

(继承自 RoutedEventArgs)

方法

GetDeferral()

通过创建和返回 DragOperationDeferral 对象,支持异步拖放操作。

GetPosition(UIElement)

返回相对于指定 UIElement 的放置点。

适用于

另请参阅