MouseWheelEventArgs クラス

定義

マウス デバイスのマウス ホイールの差分値の変化を通知するさまざまなイベントにデータを提供します。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
継承

次の例では、 TextBox マウスホイールが正の場合に上に移動 Delta し、 TextBox マウスホイールが負の値になると下に移動し Delta ます。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. TextBox にアタッチされ 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

注釈

MouseWheelEventArgs は、次のイベントで使用されます。MouseWheelEventArgs is used with the following events:

マウスホイールを上または下に移動した Delta 場合 (ユーザーに向かって離れた場合)、プロパティは正の値になります。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).

このイベントは、マウスホイールを小さく移動する場合にも発生します。This event is raised even for small mouse wheel movements. 一部のシナリオでは、デルタが特定のしきい値を超えているかどうかをチェックすることによって、小さいマウスホイールのデルタを調整するハンドラーを実装することが適切です。For some scenarios, it is appropriate to implement handlers that throttle small mouse wheel deltas by checking whether the delta exceeds a certain threshold. そうしないと、マウスホイールの差が小さく、マウスホイールの動きに関連付けられている UI が更新されない場合に、ハンドラーを呼び出すことができます。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. ハンドラーでしきい値の動作を実装する方法と、そのしきい値を完全に実装固有のものにする必要があります。Exactly how you implement the threshold behavior in a handler and what that threshold should be is entirely implementation-specific.

コンストラクター

MouseWheelEventArgs(MouseDevice, Int32, Int32)

MouseWheelEventArgs クラスの新しいインスタンスを初期化します。Initializes a new instance of the MouseWheelEventArgs class.

プロパティ

Delta

マウス ホイールが変化した量を示す値を取得します。Gets a value that indicates the amount that the mouse wheel has changed.

Device

このイベントを開始した入力デバイスを取得します。Gets the input device that initiated this event.

(継承元 InputEventArgs)
Handled

ルーティング イベントがルートをたどる際のイベント処理の現在の状態を示す値を取得または設定します。Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.

(継承元 RoutedEventArgs)
LeftButton

マウスの左ボタンの現在の状態を取得します。Gets the current state of the left mouse button.

(継承元 MouseEventArgs)
MiddleButton

マウスの中央ボタンの現在の状態を取得します。Gets the current state of the middle mouse button.

(継承元 MouseEventArgs)
MouseDevice

このイベントに関連付けられたマウス デバイスを取得します。Gets the mouse device associated with this event.

(継承元 MouseEventArgs)
OriginalSource

親クラスによって Source が調整される前の、純粋なヒット テストで判断される元の報告ソースを取得します。Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.

(継承元 RoutedEventArgs)
RightButton

マウスの右ボタンの現在の状態を取得します。Gets the current state of the right mouse button.

(継承元 MouseEventArgs)
RoutedEvent

この RoutedEventArgs インスタンスに関連付けられている RoutedEvent を取得または設定します。Gets or sets the RoutedEvent associated with this RoutedEventArgs instance.

(継承元 RoutedEventArgs)
Source

イベントを発生させたオブジェクトへの参照を取得または設定します。Gets or sets a reference to the object that raised the event.

(継承元 RoutedEventArgs)
StylusDevice

このイベントに関連付けられたスタイラス デバイスを取得します。Gets the stylus device associated with this event.

(継承元 MouseEventArgs)
Timestamp

このイベントが発生した時刻を取得します。Gets the time when this event occurred.

(継承元 InputEventArgs)
XButton1

マウスの第 1 拡張ボタンの現在の状態を取得します。Gets the current state of the first extended mouse button.

(継承元 MouseEventArgs)
XButton2

マウスの第 2 拡張ボタンの状態を取得します。Gets the state of the second extended mouse button.

(継承元 MouseEventArgs)

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetPosition(IInputElement)

指定した要素から見た相対的なマウス ポインターの位置を返します。Returns the position of the mouse pointer relative to the specified element.

(継承元 MouseEventArgs)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
InvokeEventHandler(Delegate, Object)

型固有の方法でイベント ハンドラーを呼び出します。これにより、イベント システムの効率を高めることができます。Invokes event handlers in a type-specific way, which can increase event system efficiency.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
OnSetSource(Object)

派生クラスでオーバーライドした場合、インスタンスの Source プロパティの値が変更されるたびに、通知コールバックのエントリ ポイントを提供します。When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes.

(継承元 RoutedEventArgs)
ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)

適用対象

こちらもご覧ください