InkCollector.MouseWheel (Evento)

Artículo
10/28/2008

Actualización: noviembre 2007

Se produce cuando un usuario mueve la rueda del mouse mientras el objeto InkCollector tiene el foco.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Event MouseWheel As InkCollectorMouseWheelEventHandler
'Uso
Dim instance As InkCollector
Dim handler As InkCollectorMouseWheelEventHandler

AddHandler instance.MouseWheel, handler

public event InkCollectorMouseWheelEventHandler MouseWheel

public:
 event InkCollectorMouseWheelEventHandler^ MouseWheel {
    void add (InkCollectorMouseWheelEventHandler^ value);
    void remove (InkCollectorMouseWheelEventHandler^ value);
}

/** @event */
public void add_MouseWheel (InkCollectorMouseWheelEventHandler value)
/** @event */
public void remove_MouseWheel (InkCollectorMouseWheelEventHandler value)

JScript no admite eventos.

Comentarios

El controlador de eventos recibe un argumento de tipo CancelMouseEventArgs que contiene datos sobre este evento.

Al crear un delegado de InkCollectorMouseDownEventHandler, se identifica el método que controla el evento. Para asociarlo al controlador de eventos, se debe agregar al evento una instancia del delegado. Siempre que se produce el evento, se llama a su controlador, a menos que se quite el delegado. Para mejorar el rendimiento, el interés del evento predeterminado está desactivado, pero se activa automáticamente si se agrega un controlador de eventos.

Para mejorar el rendimiento de la entrada manuscrita en tiempo real, oculte el cursor del mouse mientras ésta se lleva a cabo. Para ello, oculte el cursor del mouse en el controlador de eventos MouseDown y muestre el cursor del mouse en el controlador de eventos MouseUp.

Nota

Las propiedades X e Y del objeto CancelMouseEventArgs están expresadas en píxeles y no en las unidades HIMETRIC que están asociadas al espacio de entrada manuscrita. Esto se debe a que este evento reemplaza al evento del mouse relacionado de una aplicación que no reconoce la pluma, y dicho tipo de aplicación se expresa en píxeles.

Ejemplos

En este ejemplo, cuando se desencadena el evento MouseWheel, se desplazan todos los trazos de acuerdo al giro y la dirección de la rueda del mouse.

Private Sub mInkObject_MouseWheel(ByVal sender As Object, ByVal e As CancelMouseEventArgs)
    Using S As Strokes = mInkObject.Ink.Strokes
        If (S.Count > 0) Then
            S.Move(0, e.Delta)
            panelInkCanvas.Invalidate()
        End If
    End Using
End Sub

private void mInkObject_MouseWheel(object sender, CancelMouseEventArgs e)
{
    using (Strokes S = mInkObject.Ink.Strokes)
    {
        if (S.Count > 0)
        {
            S.Move(0, e.Delta);
            panelInkCanvas.Invalidate();
        }
    }
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.