Evento InkCollector.MouseWheel

Articolo
10/29/2008

Aggiornamento: novembre 2007

Si verifica quando un utente sposta la rotellina del mouse mentre l'oggetto InkCollector dispone dello stato attivo.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Event MouseWheel As InkCollectorMouseWheelEventHandler
'Utilizzo
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 non supporta gli eventi.

Note

Il gestore eventi riceve un argomento di tipo CancelMouseEventArgs contenente i dati relativi a questo evento.

Quando si crea un delegato InkCollectorMouseDownEventHandler, viene identificato il metodo che gestisce l'evento. Per associare l'evento al gestore eventi in uso, aggiungere all'evento un'istanza del delegato. Il gestore eventi viene chiamato ogni volta che si verifica l'evento, a meno che non si rimuova il delegato. Per motivi di prestazioni, l'interesse dell'evento predefinito è disattivato, ma viene attivato automaticamente se si aggiunge un gestore eventi.

Per migliorare le prestazioni dell'input penna in tempo reale, nascondere il cursore del mouse durante l'immissione dell'input penna. A tale scopo, nascondere il cursore del mouse nel gestore per l'evento MouseDown e visualizzarlo nel gestore per l'evento MouseUp.

Nota

Le proprietà X e Y dell'oggetto CancelMouseEventArgs sono espresse in pixel, non in unità HIMETRIC associate allo spazio di input penna. Ciò è dovuto al fatto che questo evento sostituisce l'evento del mouse correlato di un'applicazione che non è in grado di riconoscere l'input penna e che tale tipo di applicazione è rappresentato in pixel.

Esempi

In questo esempio, quando viene generato l'evento MouseWheel, tutti i tratti vengono fatti scorrere in funzione dell'entità e della direzione della rotazione della rotella 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();
        }
    }
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.