MouseWheelEventArgs Klasse

Definition

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Stellt Daten für verschiedene Ereignisse bereit, die Änderungen am Mausraddeltawert eines Mausgeräts 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

Das folgende Beispiel bewegt sich nach TextBox oben, wenn das Mausrad Delta positiv ist und nach TextBox unten bewegt wird, wenn das Mausrad Delta negativ ist. Dies TextBox ist an eine 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

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 verschoben wird (vom Benutzer weg) oder negativ, wenn das Mausrad nach unten oder rückwärts verschoben wird (gegenüber dem Benutzer).

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

Konstruktoren

Name	Beschreibung
MouseWheelEventArgs(MouseDevice, Int32, Int32)	Initialisiert eine neue Instanz der MouseWheelEventArgs-Klasse.

Eigenschaften

Name	Beschreibung
Delta	Ruft einen Wert ab, der angibt, wie viel das Mausrad geändert hat.
Device	Ruft das Eingabegerät ab, das dieses Ereignis initiiert hat. (Geerbt von InputEventArgs)
Handled	Dient zum Abrufen oder Festlegen eines Werts, der den aktuellen Zustand der Ereignisbehandlung für ein routingfähiges Ereignis angibt, während sie die Route durchfährt. (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 Mausgerät ab, das diesem Ereignis zugeordnet ist. (Geerbt von MouseEventArgs)
OriginalSource	Ruft die ursprüngliche Berichtsquelle ab, die durch reine Treffertests bestimmt wird, bevor eine mögliche Source Anpassung durch eine übergeordnete Klasse möglich ist. (Geerbt von RoutedEventArgs)
RightButton	Ruft den aktuellen Status der rechten Maustaste ab. (Geerbt von MouseEventArgs)
RoutedEvent	Dient zum Abrufen oder Festlegen der RoutedEvent zugeordneten RoutedEventArgs Instanz. (Geerbt von RoutedEventArgs)
Source	Dient zum Abrufen oder Festlegen eines Verweises auf das Objekt, das das Ereignis ausgelöst hat. (Geerbt von RoutedEventArgs)
StylusDevice	Ruft das Eingabestiftgerät ab, das diesem Ereignis zugeordnet ist. (Geerbt von MouseEventArgs)
Timestamp	Ruft den Zeitpunkt ab, zu dem dieses Ereignis aufgetreten 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

Name	Beschreibung
GetPosition(IInputElement)	Gibt die Position des Mauszeigers relativ zum angegebenen Element zurück. (Geerbt von MouseEventArgs)
InvokeEventHandler(Delegate, Object)	Ruft Ereignishandler auf typspezifische Weise auf, wodurch die Effizienz des Ereignissystems erhöht werden kann.
OnSetSource(Object)	Wenn eine abgeleitete Klasse überschrieben wird, wird ein Benachrichtigungsrückrufeinstiegspunkt bereitgestellt, wenn sich der Wert der Source Eigenschaft einer Instanz ändert. (Geerbt von RoutedEventArgs)

Weitere Informationen

• MouseWheelDeltaForOneLine