MouseWheelEventArgs Classe

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Fornece dados para vários eventos que relatam alterações no valor delta da roda do mouse de um dispositivo do mouse.

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 a seguir move um TextBox para cima se a roda Delta do mouse for positiva e mover a TextBox roda para baixo se a roda Delta do mouse for negativa. O TextBox é anexado 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

Comentários

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 será positiva se a roda do mouse for movida para cima ou para frente (longe do usuário) ou negativa se a roda do mouse for movida para baixo ou para trás (em direção ao usuário).

Esse evento é gerado mesmo para movimentos pequenos da roda do mouse. Para alguns cenários, é apropriado implementar manipuladores que limitam deltas de roda de mouse pequenos verificando se o delta excede um determinado limite. Caso contrário, você pode invocar o manipulador para casos em que o delta da roda do mouse era tão pequeno que qualquer interface do usuário vinculada ao movimento da roda do mouse não seria atualizada. Exatamente como você implementa o comportamento de limite em um manipulador e qual deve ser esse limite é totalmente específico da implementação.

Construtores

Nome	Description
MouseWheelEventArgs(MouseDevice, Int32, Int32)	Inicializa uma nova instância da classe MouseWheelEventArgs.

Propriedades

Nome	Description
Delta	Obtém um valor que indica a quantidade que a roda do mouse alterou.
Device	Obtém o dispositivo de entrada que iniciou esse evento. (Herdado de InputEventArgs)
Handled	Obtém ou define um valor que indica o estado atual do tratamento de eventos para um evento roteado à medida que percorre a rota. (Herdado de RoutedEventArgs)
LeftButton	Obtém o estado atual do botão esquerdo do mouse. (Herdado de MouseEventArgs)
MiddleButton	Obtém o estado atual do botão do mouse do meio. (Herdado de MouseEventArgs)
MouseDevice	Obtém o dispositivo do mouse associado a esse evento. (Herdado de MouseEventArgs)
OriginalSource	Obtém a fonte de relatório original, conforme determinado pelo teste de clique puro, antes de qualquer possível Source ajuste por uma classe pai. (Herdado de RoutedEventArgs)
RightButton	Obtém o estado atual do botão direito do mouse. (Herdado de MouseEventArgs)
RoutedEvent	Obtém ou define o RoutedEvent associado a essa RoutedEventArgs instância. (Herdado de RoutedEventArgs)
Source	Obtém ou define uma referência ao objeto que gerou o evento. (Herdado de RoutedEventArgs)
StylusDevice	Obtém o dispositivo stylus associado a esse evento. (Herdado de MouseEventArgs)
Timestamp	Obtém a hora em que esse evento ocorreu. (Herdado de InputEventArgs)
XButton1	Obtém o estado atual do primeiro botão do mouse estendido. (Herdado de MouseEventArgs)
XButton2	Obtém o estado do segundo botão do mouse estendido. (Herdado de MouseEventArgs)

Métodos

Nome	Description
GetPosition(IInputElement)	Retorna a posição do ponteiro do mouse em relação ao elemento especificado. (Herdado de MouseEventArgs)
InvokeEventHandler(Delegate, Object)	Invoca manipuladores de eventos de uma maneira específica do tipo, o que pode aumentar a eficiência do sistema de eventos.
OnSetSource(Object)	Quando substituído em uma classe derivada, fornece um ponto de entrada de retorno de chamada de notificação sempre que o Source valor da propriedade de uma instância é alterado. (Herdado de RoutedEventArgs)

Confira também

• MouseWheelDeltaForOneLine