MouseEventArgs.Delta Propriété

Définition

Obtient un décompte signé du nombre de détentes de rotation de la roulette de la souris, multiplié par la constante WHEEL_DELTA. Une détente représente un cran 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é

Décompte signé du nombre de détentes de rotation de la roulette de la souris, 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 à savoir 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 par ou d’ajouter le message à un multiligne TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient un instance d’un type qui hérite de Control, tel qu’un Button ou ComboBox. Nommez ensuite le instance Control1 et vérifiez que le gestionnaire d’événements est associé à l’événementControl.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 roulette et d’un bouton de souris. La roue a des encoches discrètes, uniformément espaciées. Lorsque vous faites pivoter la roulette, un message de roue est envoyé à mesure que chaque encoche est rencontrée. Une encoche de roue, une detent, est définie 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, une valeur de 120 est la norme pour un detent. Si des souris à plus haute résolution sont introduites, la définition de WHEEL_DELTA peut devenir plus petite. La plupart des applications doivent case activée pour une valeur positive ou négative plutôt qu’un total agrégé.

S’applique à

Voir aussi