Shape.MouseWheel (Evento)

Actualización: noviembre 2007

Se produce cuando la rueda del mouse se mueve y la forma tiene el foco.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

<BrowsableAttribute(True)> _
Public Event MouseWheel As MouseEventHandler

Dim instance As Shape
Dim handler As MouseEventHandler

AddHandler instance.MouseWheel, handler

[BrowsableAttribute(true)]
public event MouseEventHandler MouseWheel

[BrowsableAttribute(true)]
public:
 event MouseEventHandler^ MouseWheel {
    void add (MouseEventHandler^ value);
    void remove (MouseEventHandler^ value);
}

JScript no admite eventos.

Comentarios

Al controlar el evento MouseWheel, es importante respetar las normas de la interfaz de usuario asociadas a la rueda del mouse. El valor de la propiedad Delta indica cuánto se ha movido la rueda del mouse. La interfaz de usuario debe desplazarse cuando el incremento acumulado de movimiento sea 120. La interfaz de usuario debe desplazarse el número de líneas lógicas devuelto por la propiedad MouseWheelScrollLines para cada valor de incremento de movimiento alcanzado. También puede desplazarse con mayor suavidad si utiliza incrementos inferiores a 120 unidades. Sin embargo, la proporción debe mantenerse constante, es decir, las líneas representadas por MouseWheelScrollLines que se desplazan por cada 120 unidades delta de movimiento de la rueda.

Los eventos del mouse se producen en el siguiente orden:

MouseEnter

MouseMove

MouseHover / MouseDown / MouseWheel

MouseUp

MouseLeave

Para obtener más información sobre cómo controlar los eventos, vea Utilizar eventos.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar el evento MouseWheel para desplazar un control RectangleShape. Este ejemplo requiere que tenga un control RectangleShape denominado RectangleShape1 en un formulario.

Private Sub RectangleShape1_MouseWheel(ByVal sender As Object, _
 ByVal e As System.Windows.Forms.MouseEventArgs) _
 Handles RectangleShape1.MouseWheel
    ' Move the shape vertically to correspond to the scrolling of the
    ' mouse wheel.
    Dim scale As Integer = e.Delta * _
      SystemInformation.MouseWheelScrollLines / 120
    RectangleShape1.Top = RectangleShape1.Top - scale
End Sub

private void rectangleShape1_MouseWheel(object sender, 
    System.Windows.Forms.MouseEventArgs e)
{
    // Move the shape vertically to correspond to the scrolling of the
    // mouse wheel.
    int scale = e.Delta * SystemInformation.MouseWheelScrollLines / 120;
    rectangleShape1.Top = rectangleShape1.Top - scale;
}

Permisos

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.