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