UIElement.Drop Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит, когда система ввода сообщает о базовом событии удаления с этим элементом в качестве цели удаления.
public:
virtual event DragEventHandler ^ Drop;// Register
event_token Drop(DragEventHandler const& handler) const;
// Revoke with event_token
void Drop(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::Drop_revoker Drop(auto_revoke_t, DragEventHandler const& handler) const;public event DragEventHandler Drop;function onDrop(eventArgs) { /* Your code */ }
uIElement.addEventListener("drop", onDrop);
uIElement.removeEventListener("drop", onDrop);
- or -
uIElement.ondrop = onDrop;Public Custom Event Drop As DragEventHandler <uiElement Drop="eventhandler"/>
Тип события
Комментарии
Для выполнения операции drop и вызова обработчика значение AllowDrop в UIElement , который является целевым объектом перетаскивания, а также в источнике действия перетаскивания, должно иметь значение true.
Типичный обработчик проверка значение Data из данных события DragEventArgs.
Вы можете инициировать действие перетаскивания в любом элементе UIElement , вызвав метод StartDragAsync . После инициации действия любой элемент UIElement в приложении потенциально может быть целевым объектом перетаскивания, если значение AllowDrop имеет значение true для этого элемента, и любые элементы, которые передает действие перетаскивания, могут обрабатывать DragEnter, DragLeave или DragOver.
Drop — это перенаправленное событие. Элемент должен иметь значение AllowDroptrue , чтобы быть источником событий Drop. Если событие может быть пузырьково до родительских элементов, так как оно не обрабатывается, то можно обработать событие в родительском элементе, если AllowDrop имеет значение true для родительского элемента. Промежуточные элементы в маршруте, которые не являются объектом обработчика или целевым объектом удаления, не должны иметь значение true. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.
Для сенсорных действий, перетаскивания, а также для событий взаимодействия или манипуляции, которые являются последствиями сенсорного действия, элемент должен быть видимым, чтобы быть источником события и вызывать событие, связанное с действием. UIElement.Visibility должен быть видимым. Другие свойства производных типов также влияют на видимость проверки попадания, например IsEnabled. Дополнительные сведения см. в разделе Общие сведения о событиях и перенаправленных событиях.
Drop поддерживает возможность подключения обработчиков событий к маршруту, который будет вызываться, даже если данные события помечены как Handled. См . раздел AddHandler.
Определенные элементы управления среда выполнения Windows могут обрабатывать событие Drop на основе классов. В этом случае логика элемента управления, вероятно, имеет переопределение для метода OnDrop. Обычно событие помечается обработчиком класса, а событие Drop не вызывается для обработки обработчиками пользовательского кода в этом элементе управления. Дополнительные сведения см. в разделе Общие сведения о событиях и перенаправленных событиях.
Независимо от события, некоторые элементы управления могут использовать анимации темы, такие как DragItemThemeAnimation , чтобы визуально показать поведение перетаскивания для пользователя.
Windows 8/Windows 8.1 До Windows 10 среда выполнения Windows реализация концепций перетаскивания позволяет инициировать действие перетаскивания только определенным элементам управления и действиям ввода. Не существует метода StartDragAsync или универсального метода DoDragDrop , который позволил бы любому элементу пользовательского интерфейса инициировать действие перетаскивания. Main источником действия перетаскивания в приложении является перетаскивание элементов списка, например GridView.