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 evento Tapped representa un gesto, mientras que un evento PointerPressed es un evento de entrada de nivel inferior. Los eventos Punteados y PointerPressed se pueden generar como resultado de una única interacción del usuario. Si el origen del evento tiene un objeto ManipulationMode no predeterminado, manipulationStarting también se puede generar. Incluso si un control ya controla PointerPressed en la lógica de control, o está controlando manipulaciones, esto no impide que se genere Tapped.
Un evento Tapped 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 que sea un origen de eventos Tapped (true es el valor predeterminado). Es posible controlar Tapped on parent elements even if IsTapEnabled is false on the parent element, if the event bubbles to a parent from an event source child element where IsTapEnabled is 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 evento Tapped. 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 Pulsada, Mantener o algún otro gesto, por lo que no se pulsa en el instante en el 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 pulsado adicional. Si desea una lógica diferente para Tapped frente a DoubleTapped, es posible que el controlador Tapped 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 acción pulsada. 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 evento Tapped :