Partilhar via


UIElement.PointerCaptureLost Evento

Definição

Ocorre quando a captura de ponteiro anteriormente mantida por esse elemento se move para outro elemento ou em outro lugar.

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

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

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

Tipo de evento

Comentários

Importante

PointerCaptureLost pode disparar em vez de PointerReleased. Não confie em PointerPressed e PointerReleased eventos sempre ocorrendo em pares. Para funcionar corretamente, seu aplicativo deve escutar e lidar com todos os eventos que representam conclusões prováveis para a ação Pressionar e isso inclui PointerCaptureLost. Um ponteiro pode perder a captura devido a interações do usuário ou porque você capturou programaticamente outro ponteiro ou liberou a captura de ponteiro atual deliberadamente.

Não há nenhum evento que seja acionado quando um ponteiro é capturado com êxito. Para capturar um ponteiro, você chama o método CapturePointer e isso geralmente é feito no contexto de um manipulador de eventos para outros eventos de ponteiro. Para obter mais informações sobre como capturar um ponteiro e por que talvez você queira fazer isso, consulte CapturePointer ou Interações do mouse.

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

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

Aplica-se a

Confira também