InkCollectorCursorButtonUpEventHandler-Delegat

Artikel
10/28/2008

Stellt die Methode dar, die das CursorButtonUp-Ereignis eines InkCollector-Objekts behandelt.

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

Syntax

'Declaration
Public Delegate Sub InkCollectorCursorButtonUpEventHandler ( _
    sender As Object, _
    e As InkCollectorCursorButtonUpEventArgs _
)
'Usage
Dim instance As New InkCollectorCursorButtonUpEventHandler(AddressOf HandlerMethod)

public delegate void InkCollectorCursorButtonUpEventHandler(
    Object sender,
    InkCollectorCursorButtonUpEventArgs e
)

public delegate void InkCollectorCursorButtonUpEventHandler(
    Object^ sender, 
    InkCollectorCursorButtonUpEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorButtonUpEventHandler(
    Object sender,
    InkCollectorCursorButtonUpEventArgs e
)

JScript unterstützt keine Delegaten.

Parameter

sender
Typ: System.Object
Das InkCollector-Quellobjekt dieses Ereignisses.

e
Typ: Microsoft.Ink.InkCollectorCursorButtonUpEventArgs
Das InkCollectorCursorButtonUpEventArgs-Objekt, das die Ereignisdaten enthält.

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.

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 im verwalteten Code 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 InkCollector-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.