UIElement.Tapped Événement

Référence

Définition

Espace de noms:: Microsoft.UI.Xaml

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.

Modifier

Se produit lorsqu’une interaction tap non gérée 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"/>

Type d'événement

TappedEventHandler

Remarques

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

Pour plus d’informations sur l’utilisation d’une interaction tap dans votre conception d’application, consultez Conception d’interaction tactile. L’idée générale est qu’une interaction d’appui 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 les événements et PointerPressed peuvent être déclenchés à la suite d’une interaction utilisateur unique. Si la source d’événement a un ManipulationMode autre que celui par défaut, ManipulationStarting peut également être déclenché. Même si un contrôle gère déjà 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 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 pour un appui à partir de plusieurs points de pointeur.

Tapped est un événement routé. En outre, un élément doit avoir IsTapEnabled pour true être une source d’événement Tapped (true est la valeur par défaut). Il est possible de gérer sur les Tapped éléments parents, même si IsTapEnabled est false sur l’élément parent, si l’événement bulle un parent à partir d’un élément enfant de source d’événements où IsTapEnabled est 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 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 de l’événement sont marquées Handled. Consultez AddHandler.

Des contrôles Windows Runtime spécifiques peuvent également avoir une gestion basée sur des classes pour l’événementTapped. Dans ce 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.

Tapped et Holding s’excluent mutuellement. Le système d’entrée doit attendre que le 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 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, Tapped est déclenché en premier pour représenter le premier appui, mais le deuxième appui ne déclenche pas de .Tapped Si vous souhaitez une logique différente pour TappedDoubleTapped, votre Tapped gestionnaire 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 .

Appuyé pour l’entrée de la souris et du stylet/stylet

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 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 génère pas d’événements de maintien par défaut, quelle que soit la durée pendant laquelle un bouton de la souris est enfoncé ou quel bouton est maintenu.

Pour les stylos, le fait de toucher le stylet à la surface et de rester au même endroit produit une action De maintien .

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

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

S’applique à

Partager via