Langage

UIElement.Tapped Événement

Définition

Se produit lorsqu’une interaction tap non gérée n’est pas prise en charge sur la zone de test de positionnement de cet élément.

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"/>

Type d’événement

Remarques

Les appareils tactiles, les appareils de souris et le stylet peuvent tous produire une action Tap . Pour plus d’informations, consultez Gérer l’entrée du pointeur.

Pour plus d’informations sur l’utilisation d’une interaction tactile dans la conception de votre application, consultez la conception d’interaction tactile. L’idée générale est qu’une interaction Tap sur un élément appelle l’action principale de l’élément dans votre application.

Un Tapped événement représente un mouvement, tandis qu’un événement PointerPressed est un événement d’entrée de niveau inférieur. Tapped et PointerPressed les événements peuvent être déclenchés à la suite d’une interaction utilisateur unique. Si la source d’événement a un ManipulationMode non défini par défaut, ManipulationStarting peut également être déclenché. Même si un contrôle est déjà géré PointerPressed dans la logique de contrôle ou gère des manipulations, cela n’empêche Tapped pas d’être déclenché.

Un Tapped événement est potentiellement le résultat de plusieurs points de pointeur. Pour les événements de mouvement de niveau supérieur, tels que Tapped vous n’avez plus accès immédiatement aux détails PointerPoint , tels que des valeurs PointerId individuelles ou des coordonnées individuelles. Vous avez accès au type d’appareil (PointerDeviceType) et pour les coordonnées, vous pouvez appeler GetPosition, ce qui donne une moyenne des coordonnées d’un appui à partir de plusieurs points de pointeur.

Tapped est un événement routé. En outre, un élément doit avoir IsTapEnabled comme true source d’événement Tapped (true est la valeur par défaut). Il est possible de gérer Tapped les éléments parents même s’il IsTapEnabled se false trouve sur l’élément parent, si l’événement est en bulles vers un parent à partir d’un élément enfant source d’événement où IsTapEnabled est false. Pour plus d’informations sur le concept d’événement routé, consultez la vue d’ensemble des événements routés et des événements routés.

Pour les actions tactiles et pour les événements d’interaction spécifiques ou de manipulation qui sont des conséquences d’une action tactile, un élément doit être visible pour être la source d’événement. UIElement.Visibility doit être visible. D’autres propriétés des types dérivés affectent également la visibilité des tests de positionnement. Pour plus d’informations, consultez Vue d’ensemble des événements et des événements routés.

Tapped prend en charge la possibilité d’attacher des gestionnaires d’événements à l’itinéraire qui sera appelé même si les données d’événement de l’événement sont marquées Handled. Voir AddHandler.

Des contrôles Windows Runtime spécifiques peuvent également avoir une gestion basée sur des classes pour l’événementTapped. Si c’est le cas, le contrôle a probablement un remplacement pour la méthode OnTapped. Pour plus d’informations sur le fonctionnement de la gestion basée sur des classes pour les événements, consultez La vue d’ensemble des événements routés et des événements routés.

Tapped et La détention s’excluent mutuellement. Le système d’entrée doit attendre que le point de pointeur soit libéré pour déterminer si l’action doit être Tapped, Holding ou un autre mouvement, de sorte que vous n’obtenez Tapped pas à l’instant même où un utilisateur touche l’écran. Si vous avez vraiment besoin de commentaires instantanés, vous pouvez utiliser PointerPressed à la place.

Si une interaction utilisateur déclenche également DoubleTapped, Tapped est déclenché en premier pour représenter le premier appui, mais le deuxième appui ne déclenche pas d’autres Tapped. Si vous souhaitez une logique différente par Tapped rapport DoubleTappedà , votre Tapped gestionnaire peut avoir besoin d’utiliser des variables spécifiques à l’application et un minuteur afin d’éviter l’exécution sur des interactions qui sont finalement interprétées comme une action DoubleTap .

Tapé pour l’entrée de souris et de stylet/stylet

Le système d’entrée traite une action où l’utilisateur clique sur le bouton gauche de la souris tout en survolant l’élément en tant qu’action Tapped . L’événement ne se déclenche pas tant que le bouton gauche de la souris n’est pas relâché. L’entrée de la souris ne produit pas d’événements de suspension par défaut, quelle que soit la durée pendant laquelle un bouton de la souris est enfoncé ou quel bouton est conservé.

Pour les appareils à stylet, toucher l’appareil de stylet à la surface et rester dans un seul endroit produit une action de mise en attente .

Contrôles qui ne déclenchent pas l’événement Tapped

Ces contrôles ne déclenchent pas l’événement Tapped :

S’applique à

Voir aussi