Поделиться через

UIElement.PointerCanceled Событие

  • Ссылка

Определение

Пространство имен:
Microsoft.UI.Xaml
Изменить

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

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"/>

Тип события

PointerEventHandler

Комментарии

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

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

Важно!

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

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

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

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

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

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

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