MouseWheelEventArgs Classe

Definição

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

Herança

Object

EventArgs

RoutedEventArgs

InputEventArgs

MouseEventArgs

MouseWheelEventArgs

Exemplos

O exemplo seguinte move um TextBox para cima se a roda Delta do rato for positiva e move para baixo TextBox se a roda Delta do rato for negativa. O TextBox está ligado a um 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

Observações

MouseWheelEventArgs é usado com os seguintes eventos:

• UIElement.MouseWheel

• ContentElement.MouseWheel

• Mouse.MouseWheel (evento anexado)

• UIElement.PreviewMouseWheel

• ContentElement.PreviewMouseWheel

• Mouse.PreviewMouseWheel (evento anexado)

A Delta propriedade é positiva se a roda do rato for movida para cima ou para a frente (afastando-se do utilizador) ou negativa se a roda do rato for movida para baixo ou para trás (em direção ao utilizador).

Este evento é elevado mesmo para movimentos pequenos da roda do rato. Para alguns cenários, é apropriado implementar manipuladores que reduzam pequenos deltas da roda do rato, verificando se o delta ultrapassa um determinado limiar. Caso contrário, podes invocar o teu handler para casos em que a diferença na roda do rato fosse tão pequena que qualquer interface ligada ao movimento da roda do rato não fosse atualizada. A forma exata como se implementa o comportamento do limiar num handler e qual deve ser esse limiar depende totalmente da implementação.

Ver também

• MouseWheelDeltaForOneLine