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 pulsación 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 del mouse y los dispositivos de lápiz pueden producir una acción Pulsar . Para obtener más información, consulta Handle pointer input (Controlar entrada de 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 De 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 sola 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 individuales de PointerId o coordenadas individuales. Tiene acceso al tipo de dispositivo (PointerDeviceType) y, para las coordenadas, puede llamar a GetPosition, lo que proporciona un promedio de las coordenadas de un toque 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 incluso si IsTapEnabled está false en el elemento primario, si el evento se propaga a un elemento primario desde un elemento secundario de origen de eventos donde IsTapEnabled es false. Para obtener más información sobre el concepto de evento enrutado, 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 ser el origen del evento. UIElement.Visibility debe ser Visible. Otras propiedades de tipos derivados también afectan a la visibilidad de las pruebas de posicionamiento. Para obtener más información, consulta Vista general de 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 Handled. Consulte AddHandler.
Es posible que los controles de Windows Runtime específicos también tengan 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 el que un usuario toca la pantalla. Si realmente necesita comentarios instantáneos, puede 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 elemento adicional Tapped. Si desea una lógica diferente para Tapped frente DoubleTappeda , es posible que el Tapped controlador deba 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/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 se encuentra 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 de retención 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, tocar el dispositivo de lápiz a la superficie y permanecer en un solo lugar genera una acción De suspensión .
Controles que no generan el evento Tapped
Estos controles no generan el Tapped evento: