MouseEventArgs.Delta Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene un conteggio con segno del numero di dentelli in base al quale è stata spostata la rotellina del mouse moltiplicato per la costante WHEEL_DELTA. Un dentello corrisponde a uno scatto della rotellina del mouse.

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

public int Delta { get; }

member this.Delta : int

Public ReadOnly Property Delta As Integer

Valore della proprietà

Int32

Conteggio con segno del numero di dentelli in base al quale è stata spostata la rotellina del mouse moltiplicato per la costante WHEEL_DELTA.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo membro. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento Control.MouseClick . Questo report consente di apprendere quando si verifica l'evento e di facilitare il debug. Per segnalare più eventi o eventi che si verificano di frequente, provare a sostituire MessageBox.Show o Console.WriteLine accodare il messaggio a un oggetto multilinea TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di un tipo che eredita da Control, ad esempio un Button oggetto o ComboBox. Assegnare quindi un nome all'istanza Control1 e verificare che il gestore eventi sia associato all'evento 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

Commenti

La rotellina del mouse combina le caratteristiche di una rotellina e di un pulsante del mouse. La ruota ha notche discreti e a spaziatura uniforme. Quando si ruota la rotellina, viene inviato un messaggio di rotellina man mano che viene rilevata ogni notch. Una rotellina, un detent, è definita dalla costante windows WHEEL_DELTA, ovvero 120. Un valore positivo indica che la ruota è stata ruotata in avanti (lontano dall'utente); un valore negativo indica che la ruota è stata ruotata all'indietro (verso l'utente).

Attualmente, un valore pari a 120 è lo standard per un detent. Se vengono introdotti topi ad alta risoluzione, la definizione di WHEEL_DELTA potrebbe diventare più piccola. La maggior parte delle applicazioni deve verificare la presenza di un valore positivo o negativo anziché di un totale aggregato.

Vedi anche

• Button
• Clicks