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 , чтобы быть источником события манипуляции. Значение по умолчанию ManipulationModeSystem, которое позволяет встроенной логике управления обрабатывать манипуляции, но не позволяет коду приложения обрабатывать события манипуляций. Если вы хотите обрабатывать манипуляции, задайте для свойства 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.

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

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