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.

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

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