UIElement.ManipulationCompleted Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит при завершении манипуляции с UIElement .
public:
virtual event ManipulationCompletedEventHandler ^ ManipulationCompleted;// Register
event_token ManipulationCompleted(ManipulationCompletedEventHandler const& handler) const;
// Revoke with event_token
void ManipulationCompleted(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::ManipulationCompleted_revoker ManipulationCompleted(auto_revoke_t, ManipulationCompletedEventHandler const& handler) const;public event ManipulationCompletedEventHandler ManipulationCompleted;function onManipulationCompleted(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationcompleted", onManipulationCompleted);
uIElement.removeEventListener("manipulationcompleted", onManipulationCompleted);
- or -
uIElement.onmanipulationcompleted = onManipulationCompleted;Public Custom Event ManipulationCompleted As ManipulationCompletedEventHandler <uiElement ManipulationCompleted="eventhandler"/>
Тип события
Комментарии
Сведения о пользовательских элементах управления и взаимодействиях см. в разделе GestureRecognizer.ManipulationCompleted.
Элемент должен иметь значение ManipulationMode , отличное от None или System , чтобы быть источником события манипуляции. Значение по умолчанию ManipulationMode — System, которое позволяет встроенной логике управления обрабатывать манипуляции, но не позволяет коду приложения обрабатывать события манипуляции. Если вы хотите обрабатывать манипуляции, задайте для параметра ManipulationMode значение Все или определенные значения ManipulationModes . Дополнительные сведения см. в разделе ManipulationMode.
ManipulationCompleted — это перенаправленное событие. Если событие может быть пузырьково вверх до родительских элементов, так как оно остается необработанным, это событие можно обрабатывать в родительских элементах, даже если ManipulationMode имеет значение None или System в родительском элементе. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.
Для сенсорного ввода, а также событий, связанных с взаимодействием, или событий операций, которые являются следствием сенсорного ввода, элемент должен быть видимым для проверки нажатия. В таком случае элемент становится источником события и вызывает событие, сопоставленное с действием. UIElement.Visibility должен быть видимым. Другие свойства производных типов также влияют на видимость проверки попадания. Дополнительные сведения см. в разделе Общие сведения о событиях и перенаправленных событиях.
ManipulationCompleted поддерживает возможность подключения обработчиков событий к маршруту, который будет вызываться, даже если данные события помечены как Handled. См. раздел AddHandler.
Работа в Windows 8
Windows 8 не запускает ManipulationCompleted в тех случаях, когда началась инерционная фаза (и сработала операция ManipulationInertiaStarting ), но пользователь коснулся элемента до завершения прокрутки, что визуально отменяет инерционную фазу. Проблема устранена, начиная с Windows 8.1; ManipulationCompleted запускается, как только действие касания отменяет инерционную фазу.
Приложения, которые скомпилированы для Windows 8, но выполняются в Windows 8.1, продолжают использовать правила, действующие в Windows 8.