MouseWheelEventArgs Klasa

Definicja

Udostępnia dane dla różnych zdarzeń, które raportują zmiany w wartości Delta kółka myszy urządzenia myszy.Provides data for various events that report changes to the mouse wheel delta value of a mouse device.

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
Dziedziczenie

Przykłady

Poniższy przykład przesuwa się w TextBox górę, jeśli kółko myszy Delta jest dodatnie i przesuwa w TextBox dół, jeśli kółko myszy Delta jest ujemne.The following example moves a TextBox up if the mouse wheel Delta is positive and moves the TextBox down if the mouse wheel Delta is negative. TextBoxJest dołączony do Canvas .The TextBox is attached to a 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

Uwagi

MouseWheelEventArgs jest używany z następującymi zdarzeniami:MouseWheelEventArgs is used with the following events:

DeltaWłaściwość jest dodatnia, jeśli kółko myszy jest przesuwane do góry lub do przodu (od użytkownika) lub ujemne, jeśli kółko myszy jest przesunięte w dół lub w tył (w kierunku użytkownika).The Delta property is positive if the mouse wheel is moved upward or forward (away from the user) or negative if the mouse wheel is moved downward or backward (toward the user).

To zdarzenie jest wywoływane nawet w przypadku małych ruchów kółkiem myszy.This event is raised even for small mouse wheel movements. W przypadku niektórych scenariuszy zaleca się zaimplementowanie programów obsługi, które ograniczają różnice między kółkiem myszy, sprawdzając, czy Delta przekracza określony próg.For some scenarios, it is appropriate to implement handlers that throttle small mouse wheel deltas by checking whether the delta exceeds a certain threshold. W przeciwnym razie można wywołać procedurę obsługi dla przypadków, w których różnica kółka myszy była tak mała, że każdy interfejs użytkownika, który jest powiązany z ruchem kółka myszy, nie zostanie zaktualizowany.Otherwise, you might invoke your handler for cases where the mouse wheel delta was so small that any UI that is tied to the mouse wheel movement would not update. Dokładnie sposób implementacji zachowania progu w programie obsługi oraz tego, jaki próg powinien być całkowicie specyficzny dla implementacji.Exactly how you implement the threshold behavior in a handler and what that threshold should be is entirely implementation-specific.

Konstruktory

MouseWheelEventArgs(MouseDevice, Int32, Int32)

Inicjuje nowe wystąpienie klasy MouseWheelEventArgs.Initializes a new instance of the MouseWheelEventArgs class.

Właściwości

Delta

Pobiera wartość wskazującą ilość zmiany kółka myszy.Gets a value that indicates the amount that the mouse wheel has changed.

Device

Pobiera urządzenie wejściowe, które zainicjowało to zdarzenie.Gets the input device that initiated this event.

(Odziedziczone po InputEventArgs)
Handled

Pobiera lub ustawia wartość wskazującą obecny stan obsługi zdarzeń dla zdarzenia kierowanego w trakcie podróży trasy.Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.

(Odziedziczone po RoutedEventArgs)
LeftButton

Pobiera bieżący stan lewego przycisku myszy.Gets the current state of the left mouse button.

(Odziedziczone po MouseEventArgs)
MiddleButton

Pobiera bieżący stan środkowego przycisku myszy.Gets the current state of the middle mouse button.

(Odziedziczone po MouseEventArgs)
MouseDevice

Pobiera urządzenie myszy powiązane z tym zdarzeniem.Gets the mouse device associated with this event.

(Odziedziczone po MouseEventArgs)
OriginalSource

Pobiera oryginalne źródło raportowania określone przez czyste Testy trafień przed dopuszczalną Source korektą przez klasę nadrzędną.Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.

(Odziedziczone po RoutedEventArgs)
RightButton

Pobiera bieżący stan prawego przycisku myszy.Gets the current state of the right mouse button.

(Odziedziczone po MouseEventArgs)
RoutedEvent

Pobiera lub ustawia RoutedEvent skojarzenie skojarzone z tym RoutedEventArgs wystąpieniem.Gets or sets the RoutedEvent associated with this RoutedEventArgs instance.

(Odziedziczone po RoutedEventArgs)
Source

Pobiera lub ustawia odwołanie do obiektu, który wywołał zdarzenie.Gets or sets a reference to the object that raised the event.

(Odziedziczone po RoutedEventArgs)
StylusDevice

Pobiera urządzenie pióro skojarzone z tym zdarzeniem.Gets the stylus device associated with this event.

(Odziedziczone po MouseEventArgs)
Timestamp

Pobiera godzinę wystąpienia tego zdarzenia.Gets the time when this event occurred.

(Odziedziczone po InputEventArgs)
XButton1

Pobiera bieżący stan pierwszego rozszerzonego przycisku myszy.Gets the current state of the first extended mouse button.

(Odziedziczone po MouseEventArgs)
XButton2

Pobiera stan drugiego rozszerzonego przycisku myszy.Gets the state of the second extended mouse button.

(Odziedziczone po MouseEventArgs)

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetPosition(IInputElement)

Zwraca pozycję wskaźnika myszy względem określonego elementu.Returns the position of the mouse pointer relative to the specified element.

(Odziedziczone po MouseEventArgs)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InvokeEventHandler(Delegate, Object)

Wywołuje programy obsługi zdarzeń w sposób specyficzny dla typu, co może zwiększyć wydajność systemu zdarzeń.Invokes event handlers in a type-specific way, which can increase event system efficiency.

MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnSetSource(Object)

Gdy jest zastępowany w klasie pochodnej, udostępnia punkt wejścia wywołania zwrotnego powiadomienia za każdym razem, gdy wartość Source Właściwości wystąpienia zostanie zmieniona.When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes.

(Odziedziczone po RoutedEventArgs)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy

Zobacz też