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.

C#

public class MouseWheelEventArgs : System.Windows.Input.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.

C#

// 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);
        }
    }
}

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

GetPosition(IInputElement)	Zwraca położenie wskaźnika myszy względem określonego elementu. (Odziedziczone po MouseEventArgs)
InvokeEventHandler(Delegate, Object)	Wywołuje programy obsługi zdarzeń w sposób specyficzny dla typu, co może zwiększyć wydajność systemu zdarzeń.
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)

Dotyczy

Zobacz też

• MouseWheelDeltaForOneLine