UIElement.PointerWheelChanged Événement
Définition
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 lorsque la valeur delta d’une roue de pointeur change.
public:
virtual event PointerEventHandler ^ PointerWheelChanged;
// Register
event_token PointerWheelChanged(PointerEventHandler const& handler) const;
// Revoke with event_token
void PointerWheelChanged(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::PointerWheelChanged_revoker PointerWheelChanged(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerWheelChanged;
function onPointerWheelChanged(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerwheelchanged", onPointerWheelChanged);
uIElement.removeEventListener("pointerwheelchanged", onPointerWheelChanged);
- or -
uIElement.onpointerwheelchanged = onPointerWheelChanged;
Public Custom Event PointerWheelChanged As PointerEventHandler
<uielement PointerWheelChanged = "eventhandler" .../>
Type d’événement
Remarques
Lorsque vous gérez PointerWheelChanged, vous êtes généralement intéressé par la valeur de propriété MouseWheelDelta :
- Appelez GetCurrentPoint à partir du PointerRoutedEventArgs disponible pour votre gestionnaire. Cette opération renvoie un Pointeur.
- Obtenez les propriétés du Pointeur. Il contient un objet PointerPointProperties .
- Obtenez la valeur de la propriété MouseWheelDelta à partir de l’objet PointerPointProperties . Une valeur positive indique que la roue a été pivotée vers l’avant (loin de l’utilisateur) ou inclinée vers la droite ; une valeur négative indique que la roue a été pivotée vers l’arrière (vers l’utilisateur) ou inclinée vers la gauche.
Si l’élément où des événements de pointeur se produisent a une valeur ManipulationMode non par défaut, l’action peut également entraîner différents événements de manipulation comme ManipulationStarted. En outre, l’entrée de la roulette de la souris peut être gérée en tant que comportement de manipulation intégré par les contrôles, même sans ManipulationMode valeur définie. Par exemple, certains contrôles tels que GridView et ListView peuvent traiter l’entrée de roulette de la souris pour lancer une action de défilement/panoramique.
PointerWheelChanged 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.
PointerWheelChanged 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 avoir une gestion basée sur des classes pour l’événement d’entréePointerWheelChanged. Dans ce cas, le contrôle a probablement un remplacement pour la méthode OnPointerWheelChanged. En règle générale, l’événement est marqué géré par le gestionnaire de classes et l’événement PointerWheelChanged n’est pas déclenché pour la gestion par des gestionnaires de code utilisateur sur ce contrôle. Un contrôle peut le faire pour prendre en charge la traversée de ses éléments enfants à l’aide d’une action de roue de pointeur. 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.