MouseEventArgs.Delta Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

MouseEventArgs.cs

Získá znaménko počtu detentů kolečka myši otočené, vynásobené WHEEL_DELTA konstantou. Detent je jedním zářezem kolečka myši.

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

public int Delta { get; }

member this.Delta : int

Public ReadOnly Property Delta As Integer

Hodnota vlastnosti

Int32

Znaménko počtu detentů, které kolečko myši otočí, vynásobí se WHEEL_DELTA konstantou.

Příklady

Následující příklad kódu ukazuje použití tohoto člena. V tomto příkladu obslužná rutina události hlásí výskyt Control.MouseClick události. Tato sestava vám pomůže zjistit, kdy k události dojde, a může vám pomoct při ladění. Chcete-li hlásit více událostí nebo událostí, ke kterým dochází často, zvažte nahrazení MessageBox.ShowConsole.WriteLine nebo připojení zprávy do víceřádkového řetězce TextBox.

Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu, který dědí z Controlobjektu , například nebo ButtonComboBox. Potom instanci Control1 pojmenujte a ujistěte se, že je obslužná rutina události přidružená k Control.MouseClick události.

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

Poznámky

Kolečko myši kombinuje funkce kolečka a tlačítka myši. Kolo má diskrétní, rovnoměrně rozložené závorky. Když kolečko otočíte, odešle se zpráva o kolečku, protože se narazí na každý zářez. Jedno kolečko, detent, je definováno konstantou oken WHEEL_DELTA, což je 120. Kladná hodnota označuje, že kolo bylo otočené dopředu (mimo uživatele); záporná hodnota označuje, že kolo bylo otočené dozadu (směrem k uživateli).

V současné době je hodnota 120 standardem pro jeden detent. Pokud jsou zavedeny myši s vyšším rozlišením, definice WHEEL_DELTA může být menší. Většina aplikací by měla místo agregovaného součtu zkontrolovat kladnou nebo zápornou hodnotu.

Viz také

• Button
• Clicks