MouseWheelEventArgs Klasa

Definicja

Przestrzeń nazw:

System.Windows.Input

Zestaw:

PresentationCore.dll

Udostępnia dane dla różnych zdarzeń, które zgłaszają zmiany w wartości różnicowej kółka myszy urządzenia myszy.

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

Object

EventArgs

RoutedEventArgs

InputEventArgs

MouseEventArgs

MouseWheelEventArgs

Przykłady

Poniższy przykład przenosi wskaźnik w górę TextBox , jeśli koło Delta myszy jest dodatnie i przesuwa TextBox w dół, jeśli koło Delta myszy jest ujemne. Element TextBox jest dołączony do elementu 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:

• UIElement.MouseWheel

• ContentElement.MouseWheel

• Mouse.MouseWheel (dołączone zdarzenie)

• UIElement.PreviewMouseWheel

• ContentElement.PreviewMouseWheel

• Mouse.PreviewMouseWheel (dołączone zdarzenie)

Właściwość jest dodatnia Delta , jeśli koło myszy zostanie przesunięte w górę lub do przodu (z dala od użytkownika) lub ujemne, jeśli koło myszy zostanie przeniesione w dół lub do tyłu (w kierunku użytkownika).

To zdarzenie jest zgłaszane nawet w przypadku małych ruchów kółka myszy. W przypadku niektórych scenariuszy należy zaimplementować programy obsługi, które ograniczają małe różnice kół myszy, sprawdzając, czy delta przekracza określony próg. W przeciwnym razie można wywołać procedurę obsługi w przypadkach, gdy delta kółka myszy była tak mała, że każdy interfejs użytkownika powiązany z ruchem kół myszy nie zostanie zaktualizowany. Dokładnie w jaki sposób implementujesz zachowanie progu w procedurze obsługi i jaki powinien być ten próg, jest całkowicie specyficzny dla implementacji.

Konstruktory

MouseWheelEventArgs(MouseDevice, Int32, Int32)

Inicjuje nowe wystąpienie klasy MouseWheelEventArgs.

Właściwości

Delta	Pobiera wartość wskazującą, że koło myszy uległo zmianie.
Device	Pobiera urządzenie wejściowe, które zainicjowało to zdarzenie. (Odziedziczone po InputEventArgs)
Handled	Pobiera lub ustawia wartość wskazującą obecny stan obsługi zdarzeń dla zdarzenia kierowanego podczas podróży trasy. (Odziedziczone po RoutedEventArgs)
LeftButton	Pobiera bieżący stan przycisku myszy po lewej stronie. (Odziedziczone po MouseEventArgs)
MiddleButton	Pobiera bieżący stan środkowego przycisku myszy. (Odziedziczone po MouseEventArgs)
MouseDevice	Pobiera urządzenie myszy skojarzone z tym zdarzeniem. (Odziedziczone po MouseEventArgs)
OriginalSource	Pobiera oryginalne źródło raportowania określone przez testowanie trafień, przed ewentualnym Source dostosowaniem przez klasę nadrzędną. (Odziedziczone po RoutedEventArgs)
RightButton	Pobiera bieżący stan prawego przycisku myszy. (Odziedziczone po MouseEventArgs)
RoutedEvent	Pobiera lub ustawia skojarzone z tym RoutedEventArgs wystąpieniemRoutedEvent. (Odziedziczone po RoutedEventArgs)
Source	Pobiera lub ustawia odwołanie do obiektu, który wzbudził zdarzenie. (Odziedziczone po RoutedEventArgs)
StylusDevice	Pobiera urządzenie stylu skojarzone z tym zdarzeniem. (Odziedziczone po MouseEventArgs)
Timestamp	Pobiera czas wystąpienia tego zdarzenia. (Odziedziczone po InputEventArgs)
XButton1	Pobiera bieżący stan pierwszego rozszerzonego przycisku myszy. (Odziedziczone po MouseEventArgs)
XButton2	Pobiera stan drugiego rozszerzonego przycisku myszy. (Odziedziczone po MouseEventArgs)

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetPosition(IInputElement)	Zwraca położenie wskaźnika myszy względem określonego elementu. (Odziedziczone po MouseEventArgs)
GetType()	Type Pobiera bieżące wystąpienie. (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ń.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnSetSource(Object)	Po zastąpieniu w klasie pochodnej zapewnia punkt wejścia wywołania zwrotnego powiadomień za każdym razem, gdy wartość Source właściwości wystąpienia ulegnie zmianie. (Odziedziczone po RoutedEventArgs)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• MouseWheelDeltaForOneLine