MouseEventArgs.Delta プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

マウス ホイールの回転回数を表す符号付きの数値に定数 WHEEL_DELTA の値を乗算した値を取得します。 マウス ホイールのノッチ 1 つ分が 1 移動量に相当します。

public:
 property int Delta { int get(); };

public int Delta { get; }

member this.Delta : int

Public ReadOnly Property Delta As Integer

プロパティ値

Int32

マウス ホイールの回転回数を表す符号付きの数値に定数 WHEEL_DELTA の値を乗算した値。

例

次のコード例では、このメンバーの使用方法を示します。 この例では、イベント ハンドラーがイベントの Control.MouseClick 発生を報告します。 このレポートは、イベントが発生したタイミングを知るのに役立ち、デバッグに役立ちます。 複数のイベントまたは頻繁に発生するイベントを報告するには、 を Console.WriteLine に置き換えるかMessageBox.Show、複数行TextBoxにメッセージを追加することを検討してください。

コード例を実行するには、 や ComboBoxなどButton、 からControl継承する型のインスタンスを含むプロジェクトに貼り付けます。 次に、インスタンス Control1 に名前を付け、イベント ハンドラーがイベントに Control.MouseClick 関連付けられていることを確認します。

private void Control1_MouseClick(Object sender, MouseEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Button", e.Button );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Clicks", e.Clicks );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "X", e.X );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Y", e.Y );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Delta", e.Delta );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Location", e.Location );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "MouseClick Event" );
}

Private Sub Control1_MouseClick(sender as Object, e as MouseEventArgs) _ 
     Handles Control1.MouseClick

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Button", e.Button)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Clicks", e.Clicks)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "X", e.X)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Y", e.Y)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Delta", e.Delta)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Location", e.Location)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"MouseClick Event")

End Sub

注釈

マウス ホイールは、ホイールとマウス ボタンの機能を組み合わせたものです。 車輪に不連続の、均等に間隔を空けた切り欠きがある。 ホイールを回転させると、各ノッチが検出されると、ホイール メッセージが送信されます。 1 つの車輪のノッチは、120 であるウィンドウ定数WHEEL_DELTAによって定義されます。 正の値は、ホイールが (ユーザーから離れて) 前方に回転したことを示します。負の値は、ホイールが (ユーザーに向かって) 後方に回転したことを示します。

現在、値 120 は 1 回の戻り値の標準です。 より高い解像度のマウスが導入されると、WHEEL_DELTAの定義が小さくなる可能性があります。 ほとんどのアプリケーションでは、集計の合計ではなく、正または負の値をチェックする必要があります。

こちらもご覧ください

• Button
• Clicks