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"/>
Тип события
Комментарии
Сведения о пользовательских элементах управления и взаимодействиях см. в разделе GestureRecognizer.
Элемент должен иметь значение ManipulationMode , отличное от None или System , чтобы быть источником события манипуляции. Значение по умолчанию ManipulationMode — System, которое позволяет встроенной логике управления обрабатывать манипуляции, но не позволяет коду приложения обрабатывать события манипуляций. Если вы хотите обрабатывать манипуляции, задайте для свойства ManipulationMode значение Все или определенные значения ManipulationModes . Дополнительные сведения см. в разделе ManipulationMode.
ManipulationStarting запускается в основном каждый раз, когда указатель взаимодействует с элементом, в котором элемент позволяет выполнять манипуляции. Сюда входят случаи, когда манипуляция интерпретируется как жест и указатели никогда не перемещаются, например жест нажатия или удерживания . Если указатели перемещаются, после этого обычно срабатывает ManipulationStarted .
ManipulationStarting — это перенаправленное событие. Если событие может быть пузырьково до родительских элементов, так как оно не обрабатывается, то событие можно обрабатывать в родительских элементах, даже если manipulationMode имеет значение None или System в родительском элементе. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.
Для сенсорного ввода, а также событий, связанных с взаимодействием, или событий операций, которые являются следствием сенсорного ввода, элемент должен быть видимым для проверки нажатия. В таком случае элемент становится источником события и вызывает событие, сопоставленное с действием. UIElement.Visibility должен быть видимым. Другие свойства производных типов также влияют на видимость проверки попадания. Дополнительные сведения см. в разделе Общие сведения о событиях и перенаправленных событиях.
ManipulationStarting поддерживает возможность подключения обработчиков событий к маршруту, который будет вызываться, даже если данные события помечены как Handled. См . раздел AddHandler.
Работа в Windows 8
В Windows 8 возникла проблема с запуском этого события, если в течение короткого периода времени было выполнено несколько жестов. Например, Windows 8 может запускать ManipulationStarting только для первого жеста, но не для второго. Эта проблема устранена, начиная с Windows 8.1. Несколько начальных жестов, обработанных системой ввода, запускают отдельное событие ManipulationStarting.
Приложения, которые скомпилированы для Windows 8, но выполняются в Windows 8.1, продолжают использовать правила, действующие в Windows 8.