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 концепций перетаскивания позволяет инициировать действие перетаскивания только определенным элементам управления и действиям ввода. Универсальный метод, позволяющий любому элементу пользовательского интерфейса инициировать действие перетаскивания, не DoDragDrop существует. Main источником действия перетаскивания является перетаскивание элементов списка, например GridView. Для действия перетаскивания элемента списка значение Данных в данных события потенциально может быть изменено из данных, определенных элементом управления по умолчанию. Это делается путем обработки события DragItemsStarting и работы с объектом DataPackage , полученным из свойства DragItemsStartingEventArgs.Data в данных события.

Свойства

AcceptedOperation

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

AllowedOperations

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

Data

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

DataView

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

DragUIOverride

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

Handled

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

Modifiers

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

OriginalSource

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

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

Методы

GetDeferral()

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

GetPosition(UIElement)

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

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

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