UIElement.Tapped 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 se produce una interacción de tap no controlada en el área de prueba de posicionamiento de este elemento.
public:
virtual event TappedEventHandler ^ Tapped;// Register
event_token Tapped(TappedEventHandler const& handler) const;
// Revoke with event_token
void Tapped(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::Tapped_revoker Tapped(auto_revoke_t, TappedEventHandler const& handler) const;public event TappedEventHandler Tapped;function onTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("tapped", onTapped);
uIElement.removeEventListener("tapped", onTapped);
- or -
uIElement.ontapped = onTapped;Public Custom Event Tapped As TappedEventHandler <uiElement Tapped="eventhandler"/>
Tipo de evento
Comentarios
Los dispositivos táctiles, los dispositivos de mouse y los dispositivos de lápiz pueden producir una acción Pulsar . Para obtener más información, consulta Controlar la entrada del puntero.
Consulta Diseño de interacción táctil para obtener más información sobre cómo usar una interacción de pulsación en el diseño de la aplicación. La idea general es que una interacción pulsar en un elemento invoca la acción principal del elemento en la aplicación.
Un Tapped evento representa un gesto, mientras que un evento PointerPressed es un evento de entrada de nivel inferior.
Tapped y PointerPressed los eventos se pueden generar como resultado de una única interacción del usuario. Si el origen del evento tiene un objeto ManipulationMode no predeterminado, también se puede generar ManipulationStarting . Incluso si un control ya está controlando PointerPressed en la lógica de control o está controlando manipulaciones, esto no impide Tapped que se genere.
Un Tapped evento es posiblemente el resultado de más de un punto de puntero. Para los eventos de gestos de nivel superior, como Tapped ya no tiene acceso inmediato a los detalles de PointerPoint , como valores de PointerId individuales o coordenadas individuales. Tiene acceso al tipo de dispositivo (PointerDeviceType) y, para las coordenadas, puede llamar a GetPosition, que proporciona un promedio de las coordenadas de un Tap desde más de un punto de puntero.
Tapped es un evento enrutado. Además, un elemento debe tener IsTapEnabledtrue para ser un Tapped origen de eventos (true es el valor predeterminado). Es posible controlar Tapped en elementos primarios aunque IsTapEnabled esté false en el elemento primario, si el evento se propaga a un elemento primario desde un elemento secundario de origen del evento donde IsTapEnabled es false. Para obtener más información sobre el concepto de eventos enrutados, consulta Información general sobre eventos y eventos enrutados.
Para las acciones táctiles y también para los eventos de interacción específicos o de manipulación que son consecuencias de una acción táctil, un elemento debe ser visible para que sea el origen del evento. UIElement.Visibility debe ser Visible. Otras propiedades de los tipos derivados también afectan a la visibilidad de la prueba de posicionamiento. Para obtener más información, consulta Introducción a eventos y eventos enrutados.
Tapped 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.
Los controles de Windows Runtime específicos también pueden tener control basado en clases para el Tapped evento. Si es así, es probable que el control tenga una invalidación para el método OnTapped. Para obtener más información sobre cómo funciona el control basado en clases para eventos, consulta Información general sobre eventos y eventos enrutados.
Tapped y Holding son mutuamente excluyentes. El sistema de entrada debe esperar hasta que se libere el punto de puntero para determinar si la acción debe ser Tapped, Holding o algún otro gesto, por lo que no se obtiene Tapped al instante en que un usuario toca la pantalla. Si realmente necesita comentarios instantáneos, es posible que quiera usar PointerPressed en su lugar.
Si una interacción del usuario también genera DoubleTapped, Tapped se generará primero para representar la primera pulsación, pero la segunda pulsación no generará un adicional Tapped. Si desea una lógica diferente para Tapped frente DoubleTappeda , es posible que el Tapped controlador tenga que usar variables específicas de la aplicación y un temporizador para evitar ejecutarse en interacciones que finalmente se interpretan como una acción DoubleTap .
Pulsado para la entrada del mouse y lápiz y lápiz
El sistema de entrada procesa una acción en la que el usuario hace clic en el botón izquierdo del mouse mientras está sobre el elemento como una Tapped acción. El evento no se activa hasta que se suelta el botón izquierdo del mouse. La entrada del mouse no genera eventos holding de forma predeterminada, independientemente de cuánto tiempo se mantenga presionado un botón del mouse o qué botón se mantiene presionado.
En el caso de los dispositivos de lápiz, al tocar el dispositivo de lápiz a la superficie y permanecer en un solo lugar, se genera una acción De suspensión .
Controles que no generan el evento Tapped
Estos controles no generan el Tapped evento :