MouseEventArgs.Delta プロパティ

定義

マウス ホイールの回転回数を表す符号付きの数値に定数 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 報告します。 このレポートは、イベントがいつ発生するかを学習するのに役立ち、デバッグに役立ちます。 複数のイベント、または頻繁に発生するイベントに関するレポートを作成するには、メッセージを複数行TextBoxに置き換えるかMessageBox.ShowConsole.WriteLine追加することを検討してください。

コード例を実行するには、継承元の型 Controlのインスタンスを含むプロジェクトに貼り付けます (例: a Button または ComboBox. 次に、インスタンス 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 つのホイールのノッチ (ディテント) は、ウィンドウ定数 WHEEL_DELTA (120) によって定義されます。 正の値は、ホイールが (ユーザーから離れて) 前方に回転したことを示します。負の値は、ホイールが (ユーザーに向かって) 後方に回転したことを示します。

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

適用対象

こちらもご覧ください