Partager via

UIElement.PointerWheelChanged Événement

  • Référence

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

Se produit lorsque la valeur delta d’une roulette 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

PointerEventHandler

Remarques

Lorsque vous gérez PointerWheelChanged, la valeur de la propriété MouseWheelDelta vous intéresse généralement :

  1. Appelez GetCurrentPoint à partir du PointerRoutedEventArgs disponible pour votre gestionnaire. Cette opération renvoie un Pointeur.
  2. Obtenez les propriétés du Pointeur. Il contient un objet PointerPointProperties .
  3. 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ù les événements de pointeur se produisent a une valeur ManipulationMode autre que celle par défaut, l’action peut également entraîner différents événements de manipulation tels que ManipulationStarted. En outre, l’entrée de la roulette de la souris peut être gérée comme un comportement de manipulation intégré par des contrôles, même si aucune valeur n’est ManipulationMode définie. Par exemple, certains contrôles comme GridView et ListView peuvent traiter l’entrée de la 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 Vue d’ensemble des événements et des événements routés.

Pour les actions tactiles et pour les événements de manipulation ou spécifiques à l’interaction qui sont des conséquences d’une action tactile, un élément doit être visible au test de positionnement pour pouvoir ê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 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.

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 de l’événement sont marquées Handled. Consultez 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é comme géré par le gestionnaire de classe, et l’événement PointerWheelChanged n’est pas déclenché pour être géré par des gestionnaires de code utilisateur sur ce contrôle. Un contrôle peut effectuer cette opération afin de 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 les classes des événements, consultez Vue d’ensemble des événements et des événements routés.

S’applique à

Voir aussi