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 , которая выполняется независимо от события.

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

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