InkOverlay.CursorButtonUp-Ereignis

Artikel
11/26/2008

Tritt ein, wenn das InkOverlay-Objekt ein nicht ausgewähltes CursorButton-Objekt erkennt.

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

Syntax

'Declaration
Public Event CursorButtonUp As InkCollectorCursorButtonUpEventHandler
'Usage
Dim instance As InkOverlay
Dim handler As InkCollectorCursorButtonUpEventHandler

AddHandler instance.CursorButtonUp, handler

public event InkCollectorCursorButtonUpEventHandler CursorButtonUp

public:
 event InkCollectorCursorButtonUpEventHandler^ CursorButtonUp {
    void add (InkCollectorCursorButtonUpEventHandler^ value);
    void remove (InkCollectorCursorButtonUpEventHandler^ value);
}

/** @event */
public void add_CursorButtonUp (InkCollectorCursorButtonUpEventHandler value)
/** @event */
public void remove_CursorButtonUp (InkCollectorCursorButtonUpEventHandler value)

JScript unterstützt keine Ereignisse.

Hinweise

Eine Taste an der Stiftspitze ist nicht gedrückt, wenn der Benutzer einen Strich fertig stellt und den Stift vom Digitizer abhebt. Eine Taste am Schaft ist nicht aktiviert, wenn die Taste nicht gedrückt ist.

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

Beim Erstellen eines InkCollectorCursorButtonUpEventHandler-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.

Wenn Sie die rechte Maustaste loslassen, erhalten Sie zwei CursorButtonUp-Ereignisse – eines, wenn die rechte Taste nicht gedrückt ist, und eines, wenn die linke Taste nicht gedrückt ist.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die Ereignisse CursorInRange, CursorButtonDown und CursorButtonUp abonnieren können, damit der Freihandzeiger (bei der Freihandeingabe mit der Maus) mit einer anderen Farbe als die Freihandeingabe selbst angezeigt wird.

Beim Auslösen des CursorInRange-Ereignisses wird überprüft, ob das InkOverlay-Objekt zum ersten Mal Kontakt mit diesem Cursor-Objekt hat. Wenn dies der Fall ist, wird die DrawingAttributes-Eigenschaft einem Klon der DefaultDrawingAttributes-Eigenschaft zugewiesen. Hierdurch wird verhindert, dass durch den anschließenden Zugriff auf die DrawingAttributes-Eigenschaft eine NULL-Verweisausnahme ausgelöst wird. Bei Verwendung der Maus wird die Freihandfarbe in Rot geändert.

Private Sub mInkObject_CursorInRange(ByVal sender As Object, ByVal e As InkCollectorCursorInRangeEventArgs)
    Const MOUSE_CURSOR_ID As Integer = 1
    If e.NewCursor Then
        ' mInkObject can be InkCollector, InkOverlay, or InkPicture
        e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone()
        ' if this cursor is the mouse, we'll set color to red
        If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
            e.Cursor.DrawingAttributes.Color = Color.Red
        End If

    End If
End Sub

private void mInkObject_CursorInRange(object sender, InkCollectorCursorInRangeEventArgs e)
{
    const int MOUSE_CURSOR_ID = 1;

    if (e.NewCursor)
    {
        // mInkObject can be InkCollector, InkOverlay, or InkPicture
        e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone();
        // if this cursor is the mouse, we'll set color to red
        if (MOUSE_CURSOR_ID == e.Cursor.Id)
        {
            e.Cursor.DrawingAttributes.Color = Color.Red;
        }
    }
}

Beim Auslösen des CursorButtonDown-Ereignisses wird überprüft, ob das für das Ereignis bereitgestellte Cursor-Objekt die Maus ist. Wenn dies der Fall ist, wird die Color()-Eigenschaft auf die Farbe Blau festgelegt.

Private Sub mInkObject_CursorButtonDown(ByVal sender As Object, ByVal e As InkCollectorCursorButtonDownEventArgs)
    Const MOUSE_CURSOR_ID As Integer = 1
    If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
        e.Cursor.DrawingAttributes.Color = Color.Blue
    End If
End Sub

private void mInkObject_CursorButtonDown(object sender, InkCollectorCursorButtonDownEventArgs e)
{
    const int MOUSE_CURSOR_ID = 1;

    if (MOUSE_CURSOR_ID == e.Cursor.Id)
    {
        e.Cursor.DrawingAttributes.Color = Color.Blue;
    }

}

Beim Auslösen des CursorButtonUp-Ereignisses wird überprüft, ob das für das Ereignis bereitgestellte Cursor-Objekt die Maus ist. Wenn dies der Fall ist, wird die Color()-Eigenschaft auf die Farbe Rot zurückgesetzt.

Private Sub mInkObject_CursorButtonUp(ByVal sender As Object, ByVal e As InkCollectorCursorButtonUpEventArgs)
    Const MOUSE_CURSOR_ID As Integer = 1
    If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
        e.Cursor.DrawingAttributes.Color = Color.Red
    End If
End Sub

private void mInkObject_CursorButtonUp(object sender, InkCollectorCursorButtonUpEventArgs e)
{
    const int MOUSE_CURSOR_ID = 1;

    if (MOUSE_CURSOR_ID == e.Cursor.Id)
    {
        e.Cursor.DrawingAttributes.Color = Color.Red;
    }
}

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.