MouseEventArgs.Delta プロパティ

定義

マウス ホイールが回転したデテントの数にWHEEL_DELTA定数を乗算した符号付きカウントを取得します。 ディテントは、マウス ホイールの 1 つのノッチです。

public:
 property int Delta { int get(); };
public int Delta { get; }
member this.Delta : int
Public ReadOnly Property Delta As Integer

プロパティ値

マウス ホイールが回転したデテントの数の符号付きカウントに、WHEEL_DELTA定数を乗算します。

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

コード例を実行するには、ControlButtonなど、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 つの車輪の切り欠き(ディテント)は、120 であるウィンドウ定数WHEEL_DELTAによって定義されます。 正の値は、ホイールが (ユーザーから離れて) 前方に回転したことを示します。負の値は、ホイールが (ユーザーに向かって) 後方に回転したことを示します。

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

適用対象

こちらもご覧ください