UIElement.DoubleTapped Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит, когда необработанное в противном случае взаимодействие DoubleTap происходит над областью проверки попадания этого элемента.
public:
virtual event DoubleTappedEventHandler ^ DoubleTapped;// Register
event_token DoubleTapped(DoubleTappedEventHandler const& handler) const;
// Revoke with event_token
void DoubleTapped(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::DoubleTapped_revoker DoubleTapped(auto_revoke_t, DoubleTappedEventHandler const& handler) const;public event DoubleTappedEventHandler DoubleTapped;function onDoubleTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("doubletapped", onDoubleTapped);
uIElement.removeEventListener("doubletapped", onDoubleTapped);
- or -
uIElement.ondoubletapped = onDoubleTapped;Public Custom Event DoubleTapped As DoubleTappedEventHandler <uiElement DoubleTapped="eventhandler"/>
Тип события
Комментарии
Двойное взаимодействие — это просто два взаимодействия Касанием, которые происходят быстро. Точное время того, что система интерпретирует как двойное касание, регулируется пользователями с помощью параметров системы.
Дополнительные сведения об использовании взаимодействия DoubleTap в структуре приложения см. в статье Проектирование сенсорного взаимодействия.
Если при взаимодействии с пользователем также возникает ошибка DoubleTapped, сначала срабатывает тап, представляющий первый касание, но второй касание не срабатывает. Если вам нужна другая логика для Tapped и DoubleTapped, обработчику Tapped может потребоваться использовать переменные приложения и таймер, чтобы избежать выполнения при взаимодействиях, которые в конечном итоге интерпретируются как действие DoubleTap .
Событие DoubleTapped представляет жест, а событие PointerPressed — событие ввода более низкого уровня. События DoubleTapped и PointerPressed могут возникать в результате одного взаимодействия с пользователем. Даже если элемент управления уже обрабатывает события указателя в логике элемента управления или обрабатывает манипуляции, это не препятствует запуску DoubleTapped.
Событие DoubleTapped потенциально является результатом нескольких точек указателя. Для событий жестов более высокого уровня, таких как DoubleTapped, у вас больше нет немедленного доступа к сведениям PointerPoint , таким как отдельные значения PointerId или отдельные координаты. У вас есть доступ к типу устройства (PointerDeviceType) и для координат можно вызвать GetPosition, который дает среднее значение координат для DoubleTap из нескольких точек указателя.
DoubleTapped — это перенаправленное событие. Кроме того, для элемента isDoubleTapEnabled должно быть задано значение true , чтобы он был источником событий DoubleTapped (значение true — значение по умолчанию). DoubleTapped можно обрабатывать для родительских элементов, даже если isDoubleTapEnabled имеет значение false в родительском элементе, если событие перенаправляются в родительский из дочернего элемента источника события, где IsDoubleTapEnabled имеет значение false. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.
Для сенсорного ввода, а также событий, связанных с взаимодействием, или событий операций, которые являются следствием сенсорного ввода, элемент должен быть видимым для проверки нажатия. В таком случае элемент становится источником события и вызывает событие, сопоставленное с действием. UIElement.Visibility должен быть видимым. Другие свойства производных типов также влияют на видимость проверки попадания. Дополнительные сведения см. в разделе Общие сведения о событиях и перенаправленных событиях.
DoubleTapped поддерживает возможность подключения обработчиков событий к маршруту, который будет вызываться, даже если данные события помечены как Handled. См . раздел AddHandler.
Определенные среда выполнения Windows элементы управления могут иметь обработку на основе классов для события ввода DoubleTapped. В этом случае элемент управления, вероятно, имеет переопределение для метода OnDoubleTapped. Обычно событие помечается обработчиком класса, а событие DoubleTapped не вызывается для обработки обработчиками пользовательского кода в этом элементе управления. Дополнительные сведения о том, как работает обработка событий на основе классов, см. в статье Обзор событий и перенаправленных событий.