MouseWheelEventArgs Classe

Définition

Espace de noms:

System.Windows.Input

Assembly:

PresentationCore.dll

Fournit des données pour différents événements qui signalent des modifications à la valeur delta de la roulette d'une 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 vers le haut si la roulette Delta de la souris est positive et déplace le vers le TextBox bas si la roulette Delta de la souris est négative. est TextBox 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 petits mouvements de roue de souris. Dans certains scénarios, il est approprié d’implémenter des gestionnaires qui limitent les deltas de roue 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 déplacement de la roulette de la souris ne serait pas mise à jour. La façon dont vous implémentez exactement le comportement du seuil dans un gestionnaire et ce que ce seuil doit être est entièrement spécifique à l’implémentation.

Constructeurs

MouseWheelEventArgs(MouseDevice, Int32, Int32)

Initialise une nouvelle instance de la classe MouseWheelEventArgs.

Propriétés

Delta	Obtient une valeur qui indique le montant que la roulette de la souris a modifié.
Device	Obtient le périphérique d'entrée qui a initialisé 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é le long de son 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 central de la souris. (Hérité de MouseEventArgs)
MouseDevice	Obtient la souris associée à cet événement. (Hérité de MouseEventArgs)
OriginalSource	Obtient la source de signalement d’origine telle que déterminée par un test de positionnement pur, avant tout ajustement Source pouvant être effectué 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 le RoutedEvent associé à cette instance de RoutedEventArgs. (Hérité de RoutedEventArgs)
Source	Obtient ou définit une référence à l’objet ayant déclenché l’événement. (Hérité de RoutedEventArgs)
StylusDevice	Obtient le 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

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetPosition(IInputElement)	Retourne la position du pointeur de la souris par rapport à l’élément spécifié. (Hérité de MouseEventArgs)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InvokeEventHandler(Delegate, Object)	Appelle des gestionnaires d'événements selon une méthode spécifique à un type, ce qui peut améliorer l'efficacité du système d'événements.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnSetSource(Object)	En cas de substitution dans une classe dérivée, fournit un point d'entrée de notification de rappel dès que la valeur de propriété Source d'une instance change. (Hérité de RoutedEventArgs)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• MouseWheelDeltaForOneLine