UIElement.PointerReleased Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит при освобождении устройства указателя, которое ранее инициировало действие Нажатие , в этом элементе. Обратите внимание, что окончание действия Нажатие не гарантирует, что событие будет вызываться PointerReleased . Вместо этого могут возникать другие события. Дополнительные сведения см. в разделе Примечания.
public:
virtual event PointerEventHandler ^ PointerReleased;// Register
event_token PointerReleased(PointerEventHandler const& handler) const;
// Revoke with event_token
void PointerReleased(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::PointerReleased_revoker PointerReleased(auto_revoke_t, PointerEventHandler const& handler) const;public event PointerEventHandler PointerReleased;function onPointerReleased(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerreleased", onPointerReleased);
uIElement.removeEventListener("pointerreleased", onPointerReleased);
- or -
uIElement.onpointerreleased = onPointerReleased;Public Custom Event PointerReleased As PointerEventHandler <uiElement PointerReleased="eventhandler"/>
Тип события
Комментарии
Взаимодействие сенсорного ввода, мыши и пера и пера получается, обрабатывается и управляется как ввод указателя в приложении. Любое из этих взаимодействий может привести к возникновению PointerReleased события. Дополнительные сведения см. в разделе Обработка входных данных указателя.
В конце действия могут срабатывать другие события вместо PointerReleased , например PointerCanceled или PointerCaptureLost. Не полагайтесь на события PointerPressed и PointerReleased события, которые всегда происходят парами. Для правильной работы приложение должно прослушивать и обрабатывать все события, которые представляют собой вероятные выводы действия Нажатие . Ниже приведены некоторые причины, по которым вы не можете получить вхождение PointerReleased :
- Различия в том, как конкретное оборудование обрабатывает сенсорные действия и действия нажатия
- Программный захват указателя из другого указателя
- Действия пользователя, изменяющие связь области отображения, например изменение разрешения или параметров монитора
- Взаимодействие ввода, например перо, касающееся той же поверхности, что и предыдущее действие касания
Действие пользователя, которое запускает PointerReleased событие, изначально может привести к событию Tapped или также может привести к RightTapped возникновению в условиях, которые зависят от устройства. Дополнительные сведения см. в разделах Tapped и RightTapped.
Ввод мыши связывается с отдельным указателем, назначаемым при первом обнаружении ввода мыши. При щелчке кнопки мыши (левой, правой или колеса) создается вспомогательная связь между указателем и этой кнопкой с помощью события PointerPressed. Событие PointerReleased срабатывает только при отпускании той же кнопки мыши (никакая другая кнопка не может быть связана с указателем до завершения этого события). Из-за этой исключительной связи другие щелчки кнопок мыши обрабатываются с помощью события PointerMoved. Состояние кнопки мыши можно проверить при обработке этого события, как показано в следующем примере.
PointerReleased — это перенаправленное событие. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.
Для сенсорного ввода, а также событий, связанных с взаимодействием, или событий операций, которые являются следствием сенсорного ввода, элемент должен быть видимым для проверки нажатия. В таком случае элемент становится источником события и вызывает событие, сопоставленное с действием. UIElement.Visibility должен быть видимым. Другие свойства производных типов также влияют на видимость проверки попадания. Дополнительные сведения см. в разделе Общие сведения о событиях и перенаправленных событиях.
PointerReleased поддерживает возможность подключения обработчиков событий к маршруту, который будет вызываться, даже если данные события помечены как Handled. См . раздел AddHandler.
Определенные среда выполнения Windows элементы управления могут обрабатывать событие ввода на основе PointerReleased классов. В этом случае элемент управления, вероятно, имеет переопределение для метода OnPointerReleased. Обычно событие помечается обработчиком класса, и PointerReleased событие не вызывается для обработки любыми обработчиками пользовательского кода в этом элементе управления. Дополнительные сведения о том, как работает обработка событий на основе классов, см. в статье Обзор событий и перенаправленных событий.
Элементы управления также могут иметь анимацию личности PointerUpThemeAnimation , которая выполняется независимо от события.