UIElement.PointerMoved Événement

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

Se produit lorsqu’un pointeur se déplace pendant que le pointeur reste dans la zone de test de positionnement de cet élément.

public:
 virtual event PointerEventHandler ^ PointerMoved;
// Register
event_token PointerMoved(PointerEventHandler const& handler) const;

// Revoke with event_token
void PointerMoved(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::PointerMoved_revoker PointerMoved(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerMoved;
function onPointerMoved(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointermoved", onPointerMoved);
uIElement.removeEventListener("pointermoved", onPointerMoved);
- or -
uIElement.onpointermoved = onPointerMoved;
Public Custom Event PointerMoved As PointerEventHandler 
<uiElement PointerMoved="eventhandler"/>

Type d’événement

PointerEventHandler

Remarques

Les interactions tactiles, souris et stylet/stylet sont reçues, traitées et gérées en tant qu’entrée de pointeur dans l’application UWP. L’une de ces interactions peut produire un PointerMoved événement. Pour plus d’informations, consultez La section Gérer l’entrée de pointeur et la section « PointerMoved pour la souris et l’entrée de stylet » de cette rubrique.

Dans certains scénarios d’interface utilisateur, en particulier si l’utilisateur utilise une souris, cet événement se déclenche beaucoup. Tenez compte du profil de performances du code que vous avez placé dans ce gestionnaire et envisagez d’utiliser vos propres indicateurs ou tolérances qui peuvent limiter le nombre de fois que la logique doit réellement s’exécuter.

Cet événement est un événement routé. 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 également 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 visuellement détectable pour être la source d’événement et déclencher l’événement associé à l’action. 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.

Cet événement prend également 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.

PointerMoved pour l’entrée de souris et de stylet

Un appareil d’entrée de souris a un curseur à l’écran qui est visible chaque fois que la souris se déplace sur les limites d’un élément, même si aucun bouton de la souris n’est enfoncé à l’heure. Un comportement similaire est disponible pour l’entrée d’appareil de stylet, où les appareils d’entrée peuvent détecter que le stylet pointe juste sur la surface de l’appareil d’entrée, mais ne le touche pas. L’entrée de la souris et du stylet déclenche PointerMoved donc des événements plus souvent que l’entrée tactile. Pour plus d’informations, consultez interactions avec la souris.

En revanche, un point tactile n’est détectable que si un doigt touche la surface. Un point tactile ne sera généré PointerMoved que lorsque ce point tactile reste en contact constant avec la surface au fur et à mesure qu’il se déplace. Pour ces types d’actions tactiles qui génèrent PointerMoved , il est également probable que l’action sera traitée comme une manipulation ou comme un mouvement. Pour plus d’informations, consultez Gérer l’entrée du pointeur.

L’entrée de la souris est associée à un pointeur unique affecté lorsque l’entrée de la souris est détectée pour la première fois, et toutes les interactions initiées par la souris ont le même PointerId. Cliquer sur un bouton de la souris (gauche, roue ou droite) crée une association secondaire entre le pointeur et ce bouton via l’événement PointerPressed . L’événement PointerReleased est déclenché uniquement lorsque ce même bouton de la souris est libéré (aucun autre bouton ne peut être associé au pointeur tant que cet événement n’est pas terminé). En raison de cette association exclusive, d’autres clics de bouton de souris sont routés via l’événement PointerMoved . Vous pouvez tester l’état du bouton de la souris lors de la gestion de cet événement, comme illustré dans cet exemple :

Certaines applications, telles que les jeux, doivent suivre les mouvements de souris relatifs pour des fonctionnalités spécifiques (par exemple, un trackball virtuel ou la caméra d’affichage) et n’utilisent pas le curseur système ou les coordonnées absolues de l’écran. Pour plus d’informations sur le masquage du curseur de la souris et l’ignorance des données absolues de la souris, voir Mouvement relatif de la souris et CoreWindow.

S’applique à

Voir aussi