UIElement.Tapped Événement
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsqu’une interaction Tap non prise en charge se produit sur la zone de test d’accès 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"/>
Les appareils tactiles, de souris et de stylet peuvent tous produire une action Appuyez . Pour plus d’informations, consultez Gérer l’entrée de pointeur.
Pour plus d’informations sur l’utilisation d’une interaction Tap dans la conception de votre application, consultez Conception d’interaction tactile. L’idée générale est qu’une interaction Appuy sur un élément appelle l’action principale de l’élément dans votre application.
Un événement Tappped représente un mouvement, tandis qu’un événement PointerPressed est un événement d’entrée de niveau inférieur. Les événements Tappped et PointerPressed peuvent être déclenchés à la suite d’une interaction utilisateur unique. Si la source d’événement a un ManipulationMode non défini, ManipulationStarting peut également être déclenché. Même si un contrôle gère déjà PointerPressed dans la logique de contrôle, ou qu’il gère les manipulations, cela n’empêche pas l’augmentation de l’opération Tappped.
Un événement tapé est potentiellement le résultat de plusieurs points de pointeur. Pour les événements de mouvement de niveau supérieur tels que Tappped, vous n’avez plus immédiatement accès aux détails de 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, qui donne une moyenne des coordonnées d’un appui à partir de plusieurs points de pointeur.
L’opération tapée est un événement routé. En outre, un élément doit avoir IsTapEnabled avoir la valeur true pour être une source d’événement Tapped (true est la valeur par défaut). Il est possible de gérer l’opération Tappped sur les éléments parent même si IsTapEnabled a la valeur false sur l’élément parent, si l’événement bulle un parent à partir d’un élément enfant source d’événement où IsTapEnabled a la valeur false. Pour plus d’informations sur le concept d’événement routé, consultez Vue d’ensemble des événements et des événements routés.
Pour les actions tactiles, ainsi que pour les événements spécifiques à l’interaction ou de manipulation qui sont des conséquences d’une action tactile, un élément doit être visible pour être la source de l’événement. UIElement.Visibility doit être visible. D’autres propriétés de types dérivés affectent également la visibilité des tests d’accès. 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 pour l’événement sont marquées Handled. Consultez AddHandler.
Des contrôles Windows Runtime spécifiques peuvent également avoir une gestion basée sur les classes pour l’événement Tapped. 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 les classes des événements, consultez Vue d’ensemble des événements et des événements routés.
L’appui et la conservation s’excluent mutuellement. Le système d’entrée doit attendre que le pointeur soit libéré afin de déterminer si l’action doit être tapée, tenue en attente ou un autre mouvement, afin de ne pas être appuyé au moment 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, le tapé est déclenché en premier pour représenter le premier appui, mais le deuxième appui ne déclenche pas d’appui supplémentaire. Si vous souhaitez une logique différente pour Tapped et DoubleTapped, votre gestionnaire Tapped peut avoir besoin d’utiliser des variables spécifiques à l’application et un minuteur afin d’éviter de s’exécuter sur des interactions qui sont finalement interprétées comme une action DoubleTap .
Le système d’entrée traite une action dans laquelle l’utilisateur clique sur le bouton gauche de la souris tout en survolant l’élément en tant qu’action appuyé. 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 conservation par défaut, quelle que soit la durée pendant laquelle un bouton de souris est enfoncé ou quel bouton est maintenu.
Pour les appareils à stylet, le fait de toucher le stylet à la surface et de rester au même endroit produit une action De maintien .
Ces contrôles ne déclenchent pas l’événement Tapped :
| Produit | Versions |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |