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.