MouseWheelEventArgs Classe

Definizione

Spazio dei nomi:

System.Windows.Input

Assembly:

PresentationCore.dll

Fornisce dati per vari eventi che segnalano modifiche al valore differenziale della rotellina del mouse di un dispositivo 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

L'esempio seguente sposta un oggetto TextBox su se la rotellina Delta del mouse è positiva e 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 allegato)

• UIElement.PreviewMouseWheel

• ContentElement.PreviewMouseWheel

• Mouse.PreviewMouseWheel (evento allegato)

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

Nome	Descrizione
MouseWheelEventArgs(MouseDevice, Int32, Int32)	Inizializza una nuova istanza della classe MouseWheelEventArgs.

Proprietà

Nome	Descrizione
Delta	Ottiene un valore che indica la quantità di modifica della 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 corrente della gestione degli eventi per un evento indirizzato durante il viaggio della 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 del mouse associato a questo evento. (Ereditato da MouseEventArgs)
OriginalSource	Ottiene l'origine di creazione di report originale, come determinato dall'hit testing puro, prima di qualsiasi possibile Source rettifica 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 a questa RoutedEventArgs istanza. (Ereditato da RoutedEventArgs)
Source	Ottiene o imposta un riferimento all'oggetto che ha generato l'evento. (Ereditato da RoutedEventArgs)
StylusDevice	Ottiene il dispositivo dello stilo associato a questo evento. (Ereditato da MouseEventArgs)
Timestamp	Ottiene l'ora in cui si è verificato questo evento. (Ereditato da InputEventArgs)
XButton1	Ottiene lo stato corrente del primo pulsante esteso del mouse. (Ereditato da MouseEventArgs)
XButton2	Ottiene lo stato del secondo pulsante esteso del mouse. (Ereditato da MouseEventArgs)

Metodi

Nome	Descrizione
GetPosition(IInputElement)	Restituisce la posizione del puntatore del mouse rispetto all'elemento specificato. (Ereditato da MouseEventArgs)
InvokeEventHandler(Delegate, Object)	Richiama i gestori eventi in modo specifico del tipo, che può aumentare l'efficienza del sistema eventi.
OnSetSource(Object)	Quando sottoposto a override in una classe derivata, fornisce un punto di ingresso di callback di notifica ogni volta che il valore della proprietà di un'istanza Source cambia. (Ereditato da RoutedEventArgs)

Vedi anche

• MouseWheelDeltaForOneLine