UIElement.PointerWheelChanged Événement

  • Référence

Définition

Espace de noms:
Windows.UI.Xaml
Modifier

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

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 retourne 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ù se produisent les événements de pointeur 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 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 ManipulationMode n’est définie. Par exemple, certains contrôles comme 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 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 d’accès. 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. Consultez AddHandler.

Des contrôles Windows Runtime spécifiques peuvent avoir une gestion basée sur les classes pour l’événement d’entrée PointerWheelChanged. Si c’est le 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 les 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.

Comportement de Windows 8

Pour Windows 8, les mouvements d’appareil du pavé de suivi gérés par une partie de contrôle ScrollViewer ont été interprétés comme une entrée de la roue de la souris et déclenchent donc un événement PointerWheelChanged. À compter de Windows 8.1, ScrollViewer utilise une logique de manipulation sous-jacente qui interprète les mouvements du pavé de suivi comme des actions auxquelles le ScrollViewer répond. Par conséquent, le mouvement est considéré comme géré par le contrôle et l’événement PointerWheelChanged n’est plus déclenché.

Si vous migrez le code de votre application de Windows 8 vers Windows 8.1 vous pouvez tenir compte de ce changement de comportement, car cela entraîne le déclenchement de PointerWheelChanged dans moins de cas. En outre, le comportement désormais intégré à ScrollViewer peut être dupliquer ce que votre gestionnaire aurait fait.

Les applications qui ont été compilées pour Windows 8, mais qui sont exécutées dans Windows 8.1, continuent d’appliquer le comportement Windows 8.

S’applique à

Voir aussi