MouseWheelEventArgs Třída

Definice

Obor názvů:

System.Windows.Input

Sestavení:

PresentationCore.dll

Poskytuje data pro různé události, které hlásí změny hodnoty delta kolečka myši zařízení myši.

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

Dědičnost

Object

EventArgs

RoutedEventArgs

InputEventArgs

MouseEventArgs

MouseWheelEventArgs

Příklady

Následující příklad přesune TextBox nahoru, pokud je kolečko Delta myši kladné a posune TextBox dolů, pokud je kolečko Delta myši záporné. Je TextBox připojen k .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

Poznámky

MouseWheelEventArgs se používá s následujícími událostmi:

• UIElement.MouseWheel

• ContentElement.MouseWheel

• Mouse.MouseWheel (připojená událost)

• UIElement.PreviewMouseWheel

• ContentElement.PreviewMouseWheel

• Mouse.PreviewMouseWheel (připojená událost)

Vlastnost Delta je kladná, pokud je kolečko myši posunuté nahoru nebo dopředu (mimo uživatele) nebo záporné, pokud je kolečko myši přesunuto dolů nebo dozadu (směrem k uživateli).

Tato událost je vyvolána i pro malé pohyby kolečka myši. V některých scénářích je vhodné implementovat obslužné rutiny, které omezují malé rozdíly kolečka myši tím, že zkontrolujete, jestli rozdíl překročí určitou prahovou hodnotu. Jinak byste mohli vyvolat obslužnou rutinu pro případy, kdy byl rozdíl kolečka myši tak malý, že by se neaktualizuje jakékoli uživatelské rozhraní spojené s pohybem kolečka myši. Přesně to, jak implementujete chování prahové hodnoty v obslužné rutině a jaká prahová hodnota by měla být zcela specifická pro implementaci.

Konstruktory

Name	Description
MouseWheelEventArgs(MouseDevice, Int32, Int32)	Inicializuje novou instanci MouseWheelEventArgs třídy.

Vlastnosti

Name	Description
Delta	Získá hodnotu, která označuje množství, které se změnilo kolečko myši.
Device	Získá vstupní zařízení, které iniciovalo tuto událost. (Zděděno od InputEventArgs)
Handled	Získá nebo nastaví hodnotu, která označuje aktuální stav zpracování událostí pro směrovanou událost při cestě trasu. (Zděděno od RoutedEventArgs)
LeftButton	Získá aktuální stav levého tlačítka myši. (Zděděno od MouseEventArgs)
MiddleButton	Získá aktuální stav prostředního tlačítka myši. (Zděděno od MouseEventArgs)
MouseDevice	Získá zařízení myši přidružené k této události. (Zděděno od MouseEventArgs)
OriginalSource	Získá původní zdroj sestavy určený čistým testováním hitů před případnou Source úpravou nadřazenou třídou. (Zděděno od RoutedEventArgs)
RightButton	Získá aktuální stav pravého tlačítka myši. (Zděděno od MouseEventArgs)
RoutedEvent	Získá nebo nastaví přidruženou k RoutedEvent této RoutedEventArgs instanci. (Zděděno od RoutedEventArgs)
Source	Získá nebo nastaví odkaz na objekt, který vyvolal událost. (Zděděno od RoutedEventArgs)
StylusDevice	Získá pero zařízení přidružené k této události. (Zděděno od MouseEventArgs)
Timestamp	Získá čas, kdy k této události došlo. (Zděděno od InputEventArgs)
XButton1	Získá aktuální stav prvního rozšířeného tlačítka myši. (Zděděno od MouseEventArgs)
XButton2	Získá stav druhého rozšířeného tlačítka myši. (Zděděno od MouseEventArgs)

Metody

Name	Description
GetPosition(IInputElement)	Vrátí pozici ukazatele myši vzhledem k zadanému prvku. (Zděděno od MouseEventArgs)
InvokeEventHandler(Delegate, Object)	Vyvolá obslužné rutiny událostí určitým způsobem, což může zvýšit efektivitu systému událostí.
OnSetSource(Object)	Při přepsání v odvozené třídě poskytuje vstupní bod zpětného Source volání oznámení vždy, když se změní hodnota vlastnosti instance. (Zděděno od RoutedEventArgs)

Viz také

• MouseWheelDeltaForOneLine