UIElement.PointerCanceled Событие

Определение

Происходит, когда указатель, который сделал контакт ненормальным образом, теряет контакт.

public:
 virtual event PointerEventHandler ^ PointerCanceled;
// Register
event_token PointerCanceled(PointerEventHandler const& handler) const;

// Revoke with event_token
void PointerCanceled(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::PointerCanceled_revoker PointerCanceled(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerCanceled;
function onPointerCanceled(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointercanceled", onPointerCanceled);
uIElement.removeEventListener("pointercanceled", onPointerCanceled);
- or -
uIElement.onpointercanceled = onPointerCanceled;
Public Custom Event PointerCanceled As PointerEventHandler 
<uiElement PointerCanceled="eventhandler"/>

Тип события

Комментарии

Ниже приведены некоторые причины, по которым может возникнуть событие PointerCanceled.

  • Действия пользователя, изменяющие связь области отображения, например изменение разрешения или параметров монитора
  • Входные взаимодействия, такие как перо, касающееся той же поверхности, что и предыдущее действие касания
  • Пользователь выполняет выход или аналогичные прерывания, которые не относятся к приложению
  • Число одновременных контактов превысило поддерживаемую устройством

Важно!

PointerCanceled может запускаться вместо PointerReleased. Не полагайтесь на события PointerPressed и PointerReleased , которые всегда происходят парами. Для правильной работы приложение должно прослушивать и обрабатывать все события, которые представляют возможные выводы для действия Нажатие , включая PointerCanceled.

Если срабатывает PointerCanceled, все захваты указателя этим указателем освобождаются. Дополнительные сведения о захвате указателя см. в разделе CapturePointer.

При обработке события PointerCanceled следует ожидать, что некоторые данные события, обычно доступные для события указателя, не будут иметь смысла в объекте PointerRoutedEventArgs , который вы получаете через обработчик. Например, значение Положение указателя является недопустимым, так как указатель больше не существует.

PointerCanceled — это перенаправленное событие. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.

PointerCanceled поддерживает возможность подключения обработчиков событий к маршруту, который будет вызываться, даже если данные события помечены как Handled. См. раздел AddHandler.

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

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