InkOverlay.MouseWheel-Ereignis

Artikel
11/26/2008

Tritt ein, wenn ein Benutzer das Mausrad bewegt, während das InkOverlay-Objekt den Fokus besitzt.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Event MouseWheel As InkCollectorMouseWheelEventHandler
'Usage
Dim instance As InkOverlay
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 unterstützt keine Ereignisse.

Hinweise

Der Ereignishandler empfängt ein Argument vom Typ CancelMouseEventArgs, das Daten zu diesem Ereignis enthält.

Beim Erstellen eines InkCollectorMouseDownEventHandler-Delegaten bestimmen Sie die Methode für die Ereignisbehandlung. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird. Aus Leistungsgründen ist das Standardinteresse an einem Ereignis deaktiviert, es wird jedoch automatisch aktiviert, wenn Sie einen Ereignishandler hinzufügen.

Um die Echtzeitleistung von Freihandeingaben zu erhöhen, blenden Sie den Mauszeiger während der Freihandeingabe aus. Zu diesem Zweck blenden Sie den Mauszeiger im MouseDown-Ereignishandler aus und zeigen den Mauszeiger im MouseUp-Ereignishandler an.

Hinweis

Die X-Eigenschaft und die Y-Eigenschaft des CancelMouseEventArgs-Objekts sind in Pixel und nicht in HIMETRIC-Einheiten angegeben, die dem Freihandbereich zugeordnet sind. Die Ursache hierfür ist, dass dieses Ereignis das entsprechende Mausereignis einer nicht freihandfähigen Anwendung ersetzt und dieser Typ von Anwendung mit Pixeln dargestellt wird.

Beispiele

In diesem Beispiel wird ein Bildlauf aller Striche entsprechend dem Betrag und der Richtung der Drehung des Mausrads ausgeführt, wenn das MouseWheel-Ereignis ausgelöst wird.

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();
        }
    }
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.