MouseEventArgs.Delta Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá signý počet počtu, které kolečko myši otočil, a vynásobí se WHEEL_DELTA konstantou. Detent je jeden zářez 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

Signovaný počet skrytých hodnot otočených kolečkem myši vynásobený konstantou WHEEL_DELTA.

Příklady

Následující příklad kódu ukazuje použití tohoto člena. V 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 s laděním. Pokud chcete 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 k víceřádkovému TextBoxobjektu .

Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu, která dědí z Control, například nebo ButtonComboBox. Potom pojmenujte instanci Control1 a ujistěte se, že obslužná rutina události je 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. Kolečko má diskrétní, rovnoměrně rozmístěné zářezy. Při otáčení kolečka se při každém zářezu odešle zpráva o kolečku. Jednokolový zářez, detent, je definován konstantním WHEEL_DELTA oken, 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 standardem pro jeden detent hodnota 120. 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