MouseWheelEventArgs Classe

Définition

Espace de noms:

System.Windows.Input

Assembly:

PresentationCore.dll

Fournit des données pour différents événements qui signalent les modifications apportées à la valeur delta de la roulette de la souris d’un appareil souris.

public ref class MouseWheelEventArgs : System::Windows::Input::MouseEventArgs

public class MouseWheelEventArgs : System.Windows.Input.MouseEventArgs

type MouseWheelEventArgs = class
    inherit MouseEventArgs

Public Class MouseWheelEventArgs
Inherits MouseEventArgs

Héritage

Object

EventArgs

RoutedEventArgs

InputEventArgs

MouseEventArgs

MouseWheelEventArgs

Exemples

L’exemple suivant déplace un TextBox curseur vers le haut si la roulette Delta de la souris est positive et déplace le TextBox bas si la roulette Delta de la souris est négative. L’objet TextBox est attaché à un Canvas.

// Moves the TextBox named box when the mouse wheel is rotated.
// The TextBox is on a Canvas named MainCanvas.
private void MouseWheelHandler(object sender, MouseWheelEventArgs e)
{
    // If the mouse wheel delta is positive, move the box up.
    if (e.Delta > 0)
    {
        if (Canvas.GetTop(box) >= 1)
        {
            Canvas.SetTop(box, Canvas.GetTop(box) - 1);
        }
    }

    // If the mouse wheel delta is negative, move the box down.
    if (e.Delta < 0)
    {
        if ((Canvas.GetTop(box) + box.Height) <= (MainCanvas.Height))
        {
            Canvas.SetTop(box, Canvas.GetTop(box) + 1);
        }
    }
}

' Moves the TextBox named box when the mouse wheel is rotated.
' The TextBox is on a Canvas named MainCanvas.
Private Sub MouseWheelHandler(ByVal sender As Object, ByVal e As MouseWheelEventArgs)
    ' If the mouse wheel delta is positive, move the box up.
    If e.Delta > 0 Then
        If Canvas.GetTop(box) >= 1 Then
            Canvas.SetTop(box, Canvas.GetTop(box) - 1)
        End If
    End If

    ' If the mouse wheel delta is negative, move the box down.
    If e.Delta < 0 Then
        If (Canvas.GetTop(box) + box.Height) <= MainCanvas.Height Then
            Canvas.SetTop(box, Canvas.GetTop(box) + 1)
        End If
    End If

End Sub

Remarques

MouseWheelEventArgs est utilisé avec les événements suivants :

• UIElement.MouseWheel

• ContentElement.MouseWheel

• Mouse.MouseWheel (événement attaché)

• UIElement.PreviewMouseWheel

• ContentElement.PreviewMouseWheel

• Mouse.PreviewMouseWheel (événement attaché)

La Delta propriété est positive si la roulette de la souris est déplacée vers le haut ou vers l’avant (loin de l’utilisateur) ou négative si la roulette de la souris est déplacée vers le bas ou vers l’arrière (vers l’utilisateur).

Cet événement est déclenché même pour les mouvements de la roulette de petite souris. Pour certains scénarios, il est approprié d’implémenter des gestionnaires qui limitent les deltas de la roulette de petite souris en vérifiant si le delta dépasse un certain seuil. Sinon, vous pouvez appeler votre gestionnaire pour les cas où le delta de la roulette de la souris était si petit que toute interface utilisateur liée au mouvement de la roulette de la souris ne serait pas mise à jour. Exactement la façon dont vous implémentez le comportement de seuil dans un gestionnaire et ce que ce seuil doit être entièrement spécifique à l’implémentation.

Constructeurs

Nom	Description
MouseWheelEventArgs(MouseDevice, Int32, Int32)	Initialise une nouvelle instance de la classe MouseWheelEventArgs.

Propriétés

Nom	Description
Delta	Obtient une valeur qui indique la quantité que la roulette de la souris a changé.
Device	Obtient l’appareil d’entrée qui a lancé cet événement. (Hérité de InputEventArgs)
Handled	Obtient ou définit une valeur qui indique l’état actuel de la gestion des événements pour un événement routé lors du déplacement de l’itinéraire. (Hérité de RoutedEventArgs)
LeftButton	Obtient l’état actuel du bouton gauche de la souris. (Hérité de MouseEventArgs)
MiddleButton	Obtient l’état actuel du bouton de la souris centrale. (Hérité de MouseEventArgs)
MouseDevice	Obtient l’appareil de souris associé à cet événement. (Hérité de MouseEventArgs)
OriginalSource	Obtient la source de création de rapports d’origine telle que déterminée par les tests de positionnement purs, avant tout ajustement possible Source par une classe parente. (Hérité de RoutedEventArgs)
RightButton	Obtient l’état actuel du bouton droit de la souris. (Hérité de MouseEventArgs)
RoutedEvent	Obtient ou définit l’associé RoutedEvent à cette RoutedEventArgs instance. (Hérité de RoutedEventArgs)
Source	Obtient ou définit une référence à l’objet qui a déclenché l’événement. (Hérité de RoutedEventArgs)
StylusDevice	Obtient l’appareil de stylet associé à cet événement. (Hérité de MouseEventArgs)
Timestamp	Obtient l’heure à laquelle cet événement s’est produit. (Hérité de InputEventArgs)
XButton1	Obtient l’état actuel du premier bouton étendu de la souris. (Hérité de MouseEventArgs)
XButton2	Obtient l’état du deuxième bouton étendu de la souris. (Hérité de MouseEventArgs)

Méthodes

Nom	Description
GetPosition(IInputElement)	Retourne la position du pointeur de la souris par rapport à l’élément spécifié. (Hérité de MouseEventArgs)
InvokeEventHandler(Delegate, Object)	Appelle des gestionnaires d’événements d’une manière spécifique au type, ce qui peut augmenter l’efficacité du système d’événements.
OnSetSource(Object)	En cas de substitution dans une classe dérivée, fournit un point d’entrée de rappel de notification chaque fois que la valeur de la Source propriété d’une instance change. (Hérité de RoutedEventArgs)

Voir aussi

• MouseWheelDeltaForOneLine