MouseWheelEventArgs Classe

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Fornece dados para vários eventos que relatam alterações ao valor de delta da roda do mouse de um dispositivo de 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 o TextBox para baixo se a roda Delta do mouse for negativa. O TextBox está 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 pequenos movimentos de roda do mouse. Para alguns cenários, é apropriado implementar manipuladores que limitam deltas pequenos da roda do mouse verificando se o delta excede um determinado limite. Caso contrário, você pode invocar seu 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

MouseWheelEventArgs(MouseDevice, Int32, Int32)

Inicializa uma nova instância da classe MouseWheelEventArgs.

Propriedades

Delta	Obtém um valor que indica o quanto a roda do mouse mudou.
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 de manipulação de eventos para um evento roteado enquanto ele trafega na 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 meio do mouse. (Herdado de MouseEventArgs)
MouseDevice	Obtém o dispositivo de mouse associado a este evento. (Herdado de MouseEventArgs)
OriginalSource	Obtém a origem de relatório original conforme determinada pelo teste de clique puro, antes de qualquer ajuste possível da Source por parte de 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 esta instância do RoutedEventArgs. (Herdado de RoutedEventArgs)
Source	Obtém ou define uma referência ao objeto que ativou o evento. (Herdado de RoutedEventArgs)
StylusDevice	Obtém o dispositivo de caneta associado a este 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 de mouse estendido. (Herdado de MouseEventArgs)
XButton2	Obtém o estado do segundo botão do mouse estendido. (Herdado de MouseEventArgs)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetPosition(IInputElement)	Retorna a posição do ponteiro do mouse em relação a um elemento especificado. (Herdado de MouseEventArgs)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InvokeEventHandler(Delegate, Object)	Invoca manipuladores de eventos em uma forma específica de tipo, o que pode aumentar a eficiência do sistema de eventos.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnSetSource(Object)	Quando substituído em uma classe derivada, fornece um ponto de entrada de retorno de chamada de notificação sempre que o valor da propriedade Source de uma instância muda. (Herdado de RoutedEventArgs)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• MouseWheelDeltaForOneLine