MouseWheelEventArgs Klasse

Definition

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Stellt Daten für eine Reihe von Ereignissen bereit, die Änderungen an den Deltawert eines Mausrads melden.

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

Vererbung

Object

EventArgs

RoutedEventArgs

InputEventArgs

MouseEventArgs

MouseWheelEventArgs

Beispiele

Im folgenden Beispiel wird ein TextBox nach oben verschoben, wenn das Mausrad Delta positiv ist, und nach TextBox unten verschoben, wenn das Mausrad Delta negativ ist. Der TextBox ist an einen Canvasangefügt.

// 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

Hinweise

MouseWheelEventArgs wird mit den folgenden Ereignissen verwendet:

• UIElement.MouseWheel

• ContentElement.MouseWheel

• Mouse.MouseWheel (angefügtes Ereignis)

• UIElement.PreviewMouseWheel

• ContentElement.PreviewMouseWheel

• Mouse.PreviewMouseWheel (angefügtes Ereignis)

Die Delta Eigenschaft ist positiv, wenn das Mausrad nach oben oder vorwärts (vom Benutzer entfernt) oder negativ ist, wenn das Mausrad nach unten oder rückwärts (zum Benutzer) verschoben wird.

Dieses Ereignis wird auch bei kleinen Mausradbewegungen ausgelöst. Für einige Szenarien empfiehlt es sich, Handler zu implementieren, die kleine Mausraddeltas drosseln, indem überprüft wird, ob das Delta einen bestimmten Schwellenwert überschreitet. Andernfalls können Sie Ihren Handler für Fälle aufrufen, in denen das Mausraddelta so klein war, dass eine benutzeroberfläche, die an die Mausradbewegung gebunden ist, nicht aktualisiert wird. Genau, wie Sie das Schwellenwertverhalten in einem Handler implementieren und wie dieser Schwellenwert sein sollte, ist vollständig implementierungsspezifisch.

Konstruktoren

MouseWheelEventArgs(MouseDevice, Int32, Int32)

Initialisiert eine neue Instanz der MouseWheelEventArgs-Klasse.

Eigenschaften

Delta	Ruft einen Wert ab, der den Änderungsgrad des Mausrads angibt.
Device	Ruft das Eingabegerät ab, das dieses Ereignis initiiert hat. (Geerbt von InputEventArgs)
Handled	Ruft einen Wert ab, der den aktuellen Zustand der Ereignisbehandlung für ein Routingereignis beim Durchlaufen der Route angibt, oder legt diesen fest. (Geerbt von RoutedEventArgs)
LeftButton	Ruft den aktuellen Zustand der linken Maustaste ab. (Geerbt von MouseEventArgs)
MiddleButton	Ruft den aktuellen Zustand der mittleren Maustaste ab. (Geerbt von MouseEventArgs)
MouseDevice	Ruft das diesem Ereignis zugeordnete Mausgerät ab. (Geerbt von MouseEventArgs)
OriginalSource	Ruft die ursprünglich meldende Quelle ab, die durch einen reinen Treffertest bestimmt wurde, bevor eine mögliche Source-Anpassung durch eine übergeordnete Klasse erfolgt. (Geerbt von RoutedEventArgs)
RightButton	Ruft den aktuellen Zustand der rechten Maustaste ab. (Geerbt von MouseEventArgs)
RoutedEvent	Ruft die RoutedEvent-Instanz ab, die dieser RoutedEventArgs-Instanz zugeordnet ist, oder legt die Instanz fest. (Geerbt von RoutedEventArgs)
Source	Ruft einen Verweis auf das Objekt ab, das das Ereignis ausgelöst hat, oder legt diesen fest. (Geerbt von RoutedEventArgs)
StylusDevice	Ruft das diesem Ereignis zugeordnete Tablettstiftgerät ab. (Geerbt von MouseEventArgs)
Timestamp	Ruft die Zeit ab, zu der dieses Ereignis eingetreten ist. (Geerbt von InputEventArgs)
XButton1	Ruft den aktuellen Zustand der ersten erweiterten Maustaste ab. (Geerbt von MouseEventArgs)
XButton2	Ruft den Zustand der zweiten erweiterten Maustaste ab. (Geerbt von MouseEventArgs)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetPosition(IInputElement)	Gibt die Position des Mauszeigers relativ zu einem angegebenen Element zurück. (Geerbt von MouseEventArgs)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InvokeEventHandler(Delegate, Object)	Ruft Ereignishandler auf typspezifische Weise auf, wodurch sich die Effizienz des Ereignissystems erhöhen kann.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnSetSource(Object)	Gibt beim Überschreiben in einer abgeleiteten Klasse einen Einstiegspunkt für Benachrichtigungsrückrufe an, wenn der Wert der Source-Eigenschaft einer Instanz geändert wird. (Geerbt von RoutedEventArgs)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• MouseWheelDeltaForOneLine