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 v rozdílové hodnotě 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 posune 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řidružená událost)

• UIElement.PreviewMouseWheel

• ContentElement.PreviewMouseWheel

• Mouse.PreviewMouseWheel (přidružená událost)

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

Tato událost je vyvolána i při malých pohybech 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 kontrolou, zda rozdíl nepřekračuje určitou prahovou hodnotu. V opačném případě můžete obslužnou rutinu vyvolat v případech, kdy byl rozdíl kolečka myši tak malý, že by se neaktualizovat žádné uživatelské rozhraní svázané s pohybem kolečka myši. Přesný způsob implementace chování prahové hodnoty v obslužné rutině a to, co by tato prahová hodnota měla být, je zcela specifické pro implementaci.

Konstruktory

MouseWheelEventArgs(MouseDevice, Int32, Int32)

Inicializuje novou instanci MouseWheelEventArgs třídy .

Vlastnosti

Delta	Získá hodnotu, která označuje množství, které 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ě. (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, před jakoukoli možnou 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žené 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 došlo k této události. (Zděděno od InputEventArgs)
XButton1	Získá aktuální stav první rozšířené tlačítko myši. (Zděděno od MouseEventArgs)
XButton2	Získá stav druhé rozšířené tlačítko myši. (Zděděno od MouseEventArgs)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetPosition(IInputElement)	Vrátí pozici ukazatele myši vzhledem k zadanému prvku. (Zděděno od MouseEventArgs)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InvokeEventHandler(Delegate, Object)	Vyvolá obslužné rutiny událostí způsobem specifickým pro typ, který může zvýšit efektivitu systému událostí.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnSetSource(Object)	Při přepsání v odvozené třídě poskytuje vstupní bod zpětného volání oznámení pokaždé, když se změní hodnota Source vlastnosti instance. (Zděděno od RoutedEventArgs)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• MouseWheelDeltaForOneLine