Partilhar via


UIElement.PointerCanceled Evento

Definição

Ocorre quando um ponteiro que fez contato perde contato anormalmente.

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

Tipo de evento

Comentários

Alguns dos motivos pelos quais você pode obter uma ocorrência PointerCanceled são:

  • Ações do usuário que alteram a relação da área de exibição, como alterar a resolução ou monitorar configurações
  • Interações de entrada, como uma caneta tocando na mesma superfície que uma ação de toque anterior
  • O usuário faz logoff ou interrupções semelhantes que não são específicas do aplicativo
  • O número de contatos simultâneos excedeu o número compatível com o dispositivo

Importante

PointerCanceled pode disparar em vez de PointerReleased. Não confie em eventos PointerPressed e PointerReleased sempre ocorrendo em pares. Para funcionar corretamente, seu aplicativo deve escutar e manipular todos os eventos que representam as conclusões possíveis para uma ação pressionar e que inclua PointerCanceled.

Se PointerCanceled for acionado, todas as capturas de ponteiro por esse ponteiro serão liberadas. Para obter mais informações sobre a captura de ponteiro, consulte CapturePointer.

Ao manipular um evento PointerCanceled, antecipe que alguns dos dados de evento normalmente disponíveis para um evento de ponteiro não serão significativos no objeto PointerRoutedEventArgs que você obtém por meio do manipulador. Por exemplo, a Posição do ponteiro é inválida porque o ponteiro não existe mais.

PointerCanceled é um evento roteado. Para obter mais informações sobre o conceito de evento roteado, consulte Visão geral de eventos e eventos roteado.

PointerCanceled dá suporte à capacidade de anexar manipuladores de eventos à rota que será invocada mesmo se os dados do evento estiverem marcados como Manipulados. Consulte AddHandler.

Aplica-se a

Confira também