Поделиться через


DragEventArgs Класс

Определение

Предоставляет данные для событий перетаскивания.

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
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

DragEventArgs используется в качестве данных событий для следующих событий:

Эти события являются маршрутивируемыми событиями. Изменение значения свойства Handled объекта DragEventArgs из обработчика событий может повлиять на поведение перенаправленного события. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.

Класс Control имеет предварительно проводные обработчики событий, которые производные от control типы могут переопределять, чтобы обеспечить обработку событий перетаскивания на основе класса, и эти методы также используют DragEventArgs в качестве параметра. Этими методами являются:

Реализация среда выполнения Windows принципов перетаскивания позволяет инициировать действие перетаскивания только определенным элементам управления и действиям ввода. Не существует универсального метода DoDragDrop , который позволил бы любому элементу пользовательского интерфейса инициировать действие перетаскивания. Main источником действия перетаскивания является перетаскивание элементов списка, например GridView. При перетаскивании элемента списка значение Data в данных события может быть изменено на основе данных, определенных элементом управления по умолчанию. Это делается путем обработки события DragItemsStarting и работы с объектом DataPackage , полученным из свойства DragItemsStartingEventArgs.Data в данных события.

Журнал версий

Версия Windows Версия пакета SDK Добавленная стоимость
1607 14393 AllowedOperations

Свойства

AcceptedOperation

Возвращает или задает значение, указывающее, какие операции (нет, перемещение, копирование и (или) ссылка) могут быть приняты целевым объектом события перетаскивания.

AllowedOperations

Возвращает значение, указывающее, какие операции (нет, перемещение, копирование и /или ссылка) разрешены источником события перетаскивания.

Data

Возвращает или задает объект данных (DataPackage), содержащий данные, связанные с соответствующим событием перетаскивания. Это значение полезно не во всех случаях; в частности, событие должно обрабатываться допустимым целевым объектом перетаскивания.

DataView

Возвращает доступную только для чтения копию объекта Data .

DragUIOverride

Возвращает визуальное представление перетаскиваемых данных.

Handled

Получает или задает значение, обозначающее текущее состояние обработки перенаправленного события при перемещении по маршруту.

Modifiers

Возвращает перечисление флагов, указывающее текущее состояние клавиш SHIFT, CTRL и ALT, а также состояние кнопок мыши.

OriginalSource

Возвращает ссылку на объект, который вызвал событие. Часто это часть шаблона элемента управления, а не элемент, объявленный в пользовательском интерфейсе приложения.

(Унаследовано от RoutedEventArgs)

Методы

GetDeferral()

Поддерживает асинхронные операции перетаскивания путем создания и возвращения объекта DragOperationDeferral .

GetPosition(UIElement)

Возвращает раскрывающуюся точку относительно указанного элемента UIElement.

Применяется к

См. также раздел