MouseWheelEventArgs Class

Definition

Fornisce i dati per i diversi eventi che forniscono un rapporto sulle modifiche del valore delta della rotellina del mouse.Provides data for various events that report changes to the mouse wheel delta value of a mouse device.

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
Inheritance

Examples

Nell'esempio seguente viene spostato un TextBox verso l'alto se la rotellina del mouse Delta è positiva e sposta il TextBox verso il basso se la rotellina del mouse Delta è negativa.The following example moves a TextBox up if the mouse wheel Delta is positive and moves the TextBox down if the mouse wheel Delta is negative. Il TextBox è associato a un Canvas.The TextBox is attached to a 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

Remarks

MouseWheelEventArgs viene utilizzato con gli eventi seguenti:MouseWheelEventArgs is used with the following events:

La proprietà Delta è positiva se la rotellina del mouse viene spostata verso l'alto o verso il basso (lontano dall'utente) o negativa se la rotellina del mouse viene spostata verso il basso o verso il basso (verso l'utente).The Delta property is positive if the mouse wheel is moved upward or forward (away from the user) or negative if the mouse wheel is moved downward or backward (toward the user).

Questo evento viene generato anche per piccoli movimenti della rotellina del mouse.This event is raised even for small mouse wheel movements. Per alcuni scenari, è opportuno implementare i gestori che limitano i Delta della rotellina del mouse controllando se il Delta supera una determinata soglia.For some scenarios, it is appropriate to implement handlers that throttle small mouse wheel deltas by checking whether the delta exceeds a certain threshold. In caso contrario, è possibile richiamare il gestore per i casi in cui il Delta della rotellina del mouse è stato talmente piccolo che qualsiasi interfaccia utente collegata al movimento della rotellina del mouse non verrà aggiornata.Otherwise, you might invoke your handler for cases where the mouse wheel delta was so small that any UI that is tied to the mouse wheel movement would not update. Il modo esatto in cui si implementa il comportamento della soglia in un gestore e il valore della soglia deve essere interamente specifico dell'implementazione.Exactly how you implement the threshold behavior in a handler and what that threshold should be is entirely implementation-specific.

Constructors

MouseWheelEventArgs(MouseDevice, Int32, Int32)

Inizializza una nuova istanza della classe MouseWheelEventArgs.Initializes a new instance of the MouseWheelEventArgs class.

Properties

Delta

Ottiene un valore che indica la quantità modificata dalla rotellina del mouse.Gets a value that indicates the amount that the mouse wheel has changed.

Device

Ottiene il dispositivo di input che ha avviato questo evento.Gets the input device that initiated this event.

(Inherited from InputEventArgs)
Handled

Ottiene o imposta un valore che indica lo stato presente della gestione degli eventi per un evento indirizzato quando percorre la route.Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.

(Inherited from RoutedEventArgs)
LeftButton

Ottiene lo stato corrente del pulsante sinistro del mouse.Gets the current state of the left mouse button.

(Inherited from MouseEventArgs)
MiddleButton

Ottiene lo stato corrente del pulsante centrale del mouse.Gets the current state of the middle mouse button.

(Inherited from MouseEventArgs)
MouseDevice

Ottiene il dispositivo mouse associato a questo evento.Gets the mouse device associated with this event.

(Inherited from 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.Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.

(Inherited from RoutedEventArgs)
RightButton

Ottiene lo stato corrente del pulsante destro del mouse.Gets the current state of the right mouse button.

(Inherited from MouseEventArgs)
RoutedEvent

Ottiene o imposta l'oggetto RoutedEvent associato all'istanza di RoutedEventArgs.Gets or sets the RoutedEvent associated with this RoutedEventArgs instance.

(Inherited from RoutedEventArgs)
Source

Ottiene o imposta un riferimento all'oggetto che ha generato l'evento.Gets or sets a reference to the object that raised the event.

(Inherited from RoutedEventArgs)
StylusDevice

Ottiene il dispositivo stilo associato a questo evento.Gets the stylus device associated with this event.

(Inherited from MouseEventArgs)
Timestamp

Ottiene la data e l'ora in cui si è verificato l'evento.Gets the time when this event occurred.

(Inherited from InputEventArgs)
XButton1

Ottiene lo stato corrente del primo pulsante del mouse esteso.Gets the current state of the first extended mouse button.

(Inherited from MouseEventArgs)
XButton2

Ottiene lo stato del secondo pulsante del mouse esteso.Gets the state of the second extended mouse button.

(Inherited from MouseEventArgs)

Methods

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetPosition(IInputElement)

Restituisce la posizione del puntatore del mouse relativa all'elemento specificato.Returns the position of the mouse pointer relative to the specified element.

(Inherited from MouseEventArgs)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
InvokeEventHandler(Delegate, Object)

Richiama i gestori eventi in una modalità specifica del tipo, che può aumentare l'efficienza del sistema di eventi.Invokes event handlers in a type-specific way, which can increase event system efficiency.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from 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.When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes.

(Inherited from RoutedEventArgs)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also