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 se base en los eventos PointerPressed y PointerReleased que 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 eso incluye PointerCanceled.
Si pointerCanceled se activa, se libera cualquier puntero que capture ese puntero. Para obtener más información sobre la captura de puntero, vea CapturePointer.
Al controlar un evento PointerCanceled, prevé 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, la posición del puntero no es válida 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.