MouseEventArgs.Delta Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera podpisaną liczbę odcięć obracanych kółko myszy, pomnożonej przez stałą WHEEL_DELTA. Zacięcie jest jednym wycięciem kółka myszy.

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

Wartość właściwości

Int32

Podpisana liczba odcięć obracanych kółko myszy, pomnożona przez stałą WHEEL_DELTA.

Przykłady

W poniższym przykładzie kodu pokazano użycie tego elementu członkowskiego. W tym przykładzie program obsługi zdarzeń zgłasza wystąpienie Control.MouseClick zdarzenia. Ten raport pomaga dowiedzieć się, kiedy wystąpi zdarzenie, i może pomóc w debugowaniu. Aby zgłosić wiele zdarzeń lub często występujących zdarzeń, rozważ zastąpienie MessageBox.Show komunikatu ciągiem Console.WriteLine lub dołączenie go do wielowierszowego TextBoxelementu .

Aby uruchomić przykładowy kod, wklej go w projekcie zawierającym wystąpienie typu dziedziczonego z Controlelementu , takiego jak Button lub ComboBox. Następnie nadaj wystąpieniu Control1 nazwę i upewnij się, że program obsługi zdarzeń jest skojarzony ze zdarzeniem 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

Uwagi

Kółko myszy łączy cechy koła i przycisku myszy. Koło ma dyskretne, równomiernie rozmieszczone wycięcie. Podczas obracania koła jest wysyłany komunikat koła, gdy napotkano każdy wycięcie. Jedno nacięcie koła, wyniszczanie, jest definiowane przez stałą okna WHEEL_DELTA, czyli 120. Wartość dodatnia wskazuje, że koło zostało obrócone do przodu (z dala od użytkownika); wartość ujemna wskazuje, że koło zostało obrócone do tyłu (w kierunku użytkownika).

Obecnie wartość 120 jest standardem dla jednego detentu. W przypadku wprowadzenia myszy o wyższej rozdzielczości definicja WHEEL_DELTA może stać się mniejsza. Większość aplikacji powinna sprawdzać wartość dodatnią lub ujemną, a nie sumę zagregowaną.

Dotyczy

Zobacz też