MouseEventArgs.Delta MouseEventArgs.Delta MouseEventArgs.Delta MouseEventArgs.Delta Property

Definición

Obtiene un recuento con signo del número de pasos que ha girado la rueda del mouse, multiplicado por la constante WHEEL_DELTA.Gets a signed count of the number of detents the mouse wheel has rotated, multiplied by the WHEEL_DELTA constant. Un paso es una muesca de la rueda del mouse.A detent is one notch of the mouse wheel.

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

Valor de propiedad

Recuento con signo del número de pasos que ha girado la rueda del mouse, multiplicado por la constante WHEEL_DELTA.A signed count of the number of detents the mouse wheel has rotated, multiplied by the WHEEL_DELTA constant.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este miembro.The following code example demonstrates the use of this member. En el ejemplo, un controlador de eventos informa sobre la aparición del Control.MouseClick evento.In the example, an event handler reports on the occurrence of the Control.MouseClick event. Este informe le ayuda a saber cuándo se produce el evento y puede ayudarle a depurar.This report helps you learn when the event occurs and can assist you in debugging. Para notificar varios eventos o eventos que se producen con frecuencia, considere MessageBox.Show la Console.WriteLine posibilidad de reemplazar por o anexar el TextBoxmensaje a una multilínea.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de un tipo que herede de Control, Button como o ComboBox.To run the example code, paste it into a project that contains an instance of a type that inherits from Control, such as a Button or ComboBox. A continuación, asigne Control1 un nombre a la instancia y asegúrese de que el Control.MouseClick controlador de eventos está asociado al evento.Then name the instance Control1 and ensure that the event handler is associated with the Control.MouseClick event.

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

Comentarios

La rueda del mouse combina las características de una rueda y un botón del mouse.The mouse wheel combines the features of a wheel and a mouse button. La rueda tiene muescas discretas, separadas uniformemente.The wheel has discrete, evenly spaced notches. Al girar la rueda, se envía un mensaje de rueda a medida que se encuentra cada muesca.When you rotate the wheel, a wheel message is sent as each notch is encountered. Una muesca de rueda, una DETENT, se define mediante la constante de Windows WHEEL_DELTA, que es 120.One wheel notch, a detent, is defined by the windows constant WHEEL_DELTA, which is 120. Un valor positivo indica que la rueda se giró hacia delante (alejándose del usuario); un valor negativo indica que la rueda se giró hacia atrás (hacia el usuario).A positive value indicates that the wheel was rotated forward (away from the user); a negative value indicates that the wheel was rotated backward (toward the user).

Actualmente, un valor de 120 es el estándar de un DETENT.Currently, a value of 120 is the standard for one detent. Si se introducen ratones de mayor resolución, la definición de WHEEL_DELTA podría ser más pequeña.If higher resolution mice are introduced, the definition of WHEEL_DELTA might become smaller. La mayoría de las aplicaciones deben comprobar si hay un valor positivo o negativo en lugar de un total agregado.Most applications should check for a positive or negative value rather than an aggregate total.

Se aplica a

Consulte también: