UIElement.PointerCanceled Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce cuando un puntero que hizo contacto pierde de forma anómala el contacto.
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
Comentarios
Algunas de las razones por las que puede obtener una repetición PointerCanceled son:
- Acciones del usuario que cambian la relación del área de presentación, como cambiar la resolución o la configuración del monitor
- Interacciones de entrada como un lápiz óptico tocando la misma superficie que una acción táctil anterior
- El usuario cierra sesión o interrupciones similares que no son específicas de la aplicación.
- El número de contactos simultáneos superó el número admitido por el dispositivo.
Importante
PointerCanceled
podría activarse en lugar de PointerReleased. No confíes en PointerPressed yPointerReleased
los eventos siempre se producen en pares. Para funcionar correctamente, la aplicación debe escuchar y controlar todos los eventos que representan las posibles conclusiones de una acción Press y que incluyePointerCanceled
.
Si PointerCanceled
se activa, se liberan los punteros capturados por ese puntero. Para obtener más información sobre la captura de puntero, vea CapturePointer.
Al controlar un PointerCanceled
evento, anticipe que algunos de los datos del evento normalmente disponibles para un evento de puntero no serán significativos en el objeto PointerRoutedEventArgs que obtenga a través del controlador. Por ejemplo, Microsoft.UI.Input.PointerPoint.Position del puntero no es válido porque el puntero ya no existe.
PointerCanceled
es un evento enrutado. Para obtener más información sobre el concepto de eventos enrutados, consulta Información general sobre eventos y eventos enrutados.
PointerCanceled
admite la capacidad de adjuntar controladores de eventos a la ruta que se invocará incluso si los datos del evento se marcan como Controlado. Consulte AddHandler.