MouseWheelEventArgs クラス

リファレンス

定義

名前空間:: System.Windows.Input

アセンブリ:: PresentationCore.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

マウスデバイスのマウスホイールの差分値の変化を通知するさまざまなイベントにデータを提供します。

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

継承: Object

EventArgs

RoutedEventArgs

InputEventArgs

MouseEventArgs
MouseWheelEventArgs

例

次の例では、TextBoxマウスホイールが正の場合は上に移動し、マウスホイールDelta Deltaが負のTextBox場合は下に移動します。は TextBox に 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 は、次のイベントで使用されます。

このプロパティは Delta 、マウスホイールを上または前方 (ユーザーから離れた場所) に移動する場合は正、マウスホイールを下方向または後方 (ユーザー方向) に移動した場合は負の値になります。

このイベントは、小さなマウスホイールの動きでも発生します。一部のシナリオでは、デルタが特定のしきい値を超えているかどうかを確認することで、小さなマウスホイールデルタを調整するハンドラーを実装することをお勧めします。それ以外の場合は、マウスホイールのデルタが非常に小さいため、マウスホイールの動きに関連付けられている UI が更新されない場合にハンドラーを呼び出すことができます。ハンドラーでしきい値の動作を実装する方法と、そのしきい値を実装する方法は、完全に実装固有です。

コンストラクター

MouseWheelEventArgs(MouseDevice, Int32, Int32)

MouseWheelEventArgs クラスの新しいインスタンスを初期化します。

プロパティ

Delta	マウスホイールが変化した量を示す値を取得します。
Device	このイベントを開始した入力デバイスを取得します。 (継承元 InputEventArgs)
Handled	ルーティングイベントがルートをたどる際のイベント処理の現在の状態を示す値を取得または設定します。 (継承元 RoutedEventArgs)
LeftButton	マウスの左ボタンの現在の状態を取得します。 (継承元 MouseEventArgs)
MiddleButton	マウスの中央ボタンの現在の状態を取得します。 (継承元 MouseEventArgs)
MouseDevice	このイベントに関連付けられたマウスデバイスを取得します。 (継承元 MouseEventArgs)
OriginalSource	親クラスによって Source が調整される前の、純粋なヒットテストで判断される元の報告ソースを取得します。 (継承元 RoutedEventArgs)
RightButton	マウスの右ボタンの現在の状態を取得します。 (継承元 MouseEventArgs)
RoutedEvent	この RoutedEventArgs インスタンスに関連付けられている RoutedEvent を取得または設定します。 (継承元 RoutedEventArgs)
Source	イベントを発生させたオブジェクトへの参照を取得または設定します。 (継承元 RoutedEventArgs)
StylusDevice	このイベントに関連付けられたスタイラスデバイスを取得します。 (継承元 MouseEventArgs)
Timestamp	このイベントが発生した時刻を取得します。 (継承元 InputEventArgs)
XButton1	マウスの第 1 拡張ボタンの現在の状態を取得します。 (継承元 MouseEventArgs)
XButton2	マウスの第 2 拡張ボタンの状態を取得します。 (継承元 MouseEventArgs)

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetPosition(IInputElement)	指定した要素から見た相対的なマウスポインターの位置を返します。 (継承元 MouseEventArgs)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InvokeEventHandler(Delegate, Object)	型固有の方法でイベントハンドラーを呼び出します。これにより、イベントシステムの効率を高めることができます。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnSetSource(Object)	派生クラスでオーバーライドした場合、インスタンスの Source プロパティの値が変更されるたびに、通知コールバックのエントリポイントを提供します。 (継承元 RoutedEventArgs)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

適用対象

こちらもご覧ください

MouseWheelDeltaForOneLine