MouseWheelEventArgs Classe

Definizione

Spazio dei nomi:

System.Windows.Input

Assembly:

PresentationCore.dll

Fornisce i dati per i diversi eventi che forniscono un rapporto sulle modifiche del valore delta della rotellina del 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

Ereditarietà

Object

EventArgs

RoutedEventArgs

InputEventArgs

MouseEventArgs

MouseWheelEventArgs

Esempio

Nell'esempio seguente un TextBox oggetto viene spostato verso l'alto se la rotellina Delta del mouse è positiva e si sposta verso il TextBox basso se la rotellina Delta del mouse è negativa. L'oggetto TextBox è associato a un oggetto 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

Commenti

MouseWheelEventArgs viene usato con gli eventi seguenti:

• UIElement.MouseWheel

• ContentElement.MouseWheel

• Mouse.MouseWheel (evento associato)

• UIElement.PreviewMouseWheel

• ContentElement.PreviewMouseWheel

• Mouse.PreviewMouseWheel (evento associato)

La Delta proprietà è positiva se la rotellina del mouse viene spostata verso l'alto o in avanti (lontano dall'utente) o negativa se la rotellina del mouse viene spostata verso il basso o all'indietro (verso l'utente).

Questo evento viene generato anche per piccoli movimenti della rotellina del mouse. Per alcuni scenari, è opportuno implementare gestori che limitano i delta della rotellina del mouse di piccole dimensioni controllando se il delta supera una determinata soglia. In caso contrario, è possibile richiamare il gestore per i casi in cui il delta della rotellina del mouse era così piccolo che qualsiasi interfaccia utente collegata al movimento della rotellina del mouse non verrà aggiornata. Esattamente come implementare il comportamento soglia in un gestore e quale soglia deve essere interamente specifica dell'implementazione.

Costruttori

MouseWheelEventArgs(MouseDevice, Int32, Int32)

Inizializza una nuova istanza della classe MouseWheelEventArgs.

Proprietà

Delta	Ottiene un valore che indica la quantità modificata dalla rotellina del mouse.
Device	Ottiene il dispositivo di input che ha avviato questo evento. (Ereditato da InputEventArgs)
Handled	Ottiene o imposta un valore che indica lo stato presente della gestione degli eventi per un evento indirizzato quando percorre la route. (Ereditato da RoutedEventArgs)
LeftButton	Ottiene lo stato corrente del pulsante sinistro del mouse. (Ereditato da MouseEventArgs)
MiddleButton	Ottiene lo stato corrente del pulsante centrale del mouse. (Ereditato da MouseEventArgs)
MouseDevice	Ottiene il dispositivo mouse associato a questo evento. (Ereditato da MouseEventArgs)
OriginalSource	Ottiene l'origine di segnalazione originale in base a quanto determinato dall'hit testing puro, prima di qualsiasi possibile modifica di Source da parte di una classe padre. (Ereditato da RoutedEventArgs)
RightButton	Ottiene lo stato corrente del pulsante destro del mouse. (Ereditato da MouseEventArgs)
RoutedEvent	Ottiene o imposta l'oggetto RoutedEvent associato all'istanza di RoutedEventArgs. (Ereditato da RoutedEventArgs)
Source	Ottiene o imposta un riferimento all'oggetto che ha generato l'evento. (Ereditato da RoutedEventArgs)
StylusDevice	Ottiene il dispositivo stilo associato a questo evento. (Ereditato da MouseEventArgs)
Timestamp	Ottiene la data e l'ora in cui si è verificato l'evento. (Ereditato da InputEventArgs)
XButton1	Ottiene lo stato corrente del primo pulsante del mouse esteso. (Ereditato da MouseEventArgs)
XButton2	Ottiene lo stato del secondo pulsante del mouse esteso. (Ereditato da MouseEventArgs)

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetPosition(IInputElement)	Restituisce la posizione del puntatore del mouse relativa all'elemento specificato. (Ereditato da MouseEventArgs)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InvokeEventHandler(Delegate, Object)	Richiama i gestori eventi in una modalità specifica del tipo, che può aumentare l'efficienza del sistema di eventi.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnSetSource(Object)	Se sottoposto a override in una classe derivata, fornisce un punto di ingresso di callback di notifica a ogni modifica del valore della proprietà Source di un'istanza. (Ereditato da RoutedEventArgs)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• MouseWheelDeltaForOneLine