MouseEventArgs.Delta Propriété

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
MouseEventArgs.cs
Source:
MouseEventArgs.cs
Source:
MouseEventArgs.cs
Source:
MouseEventArgs.cs
Source:
MouseEventArgs.cs

Obtient un nombre signé du nombre de détents que la roulette de la souris a pivoté, multiplié par la constante WHEEL_DELTA. Un detent est un notch de la roulette de la souris.

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

Valeur de propriété

Int32

Nombre signé du nombre de detents que la roulette de la souris a pivoté, multiplié par la constante WHEEL_DELTA.

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement Control.MouseClick . Ce rapport vous aide à apprendre quand l’événement se produit et peut vous aider à déboguer. Pour signaler plusieurs événements ou événements qui se produisent fréquemment, envisagez de MessageBox.ShowConsole.WriteLine remplacer ou d’ajouter le message à un multiligne TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance d’un type qui hérite Control, par exemple un Button ou ComboBox. Nommez ensuite l’instance Control1 et vérifiez que le gestionnaire d’événements est associé à l’événement 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

Remarques

La roulette de la souris combine les caractéristiques d’une roue et d’un bouton de la souris. La roue a des notches discrètes et uniformément espaquées. Lorsque vous faites pivoter la roue, un message de roue est envoyé à mesure que chaque notch est rencontré. Un noteur de roue, un detent, est défini par la constante windows WHEEL_DELTA, qui est 120. Une valeur positive indique que la roue a été pivotée vers l’avant (loin de l’utilisateur) ; une valeur négative indique que la roue a été pivotée vers l’arrière (vers l’utilisateur).

Actuellement, la valeur 120 est la norme d’un detent. Si des souris de résolution supérieure sont introduites, la définition de WHEEL_DELTA peut devenir plus petite. La plupart des applications doivent rechercher une valeur positive ou négative plutôt qu’un total agrégé.

S’applique à

Voir aussi