InkCollectorCursorButtonDownEventHandler-Delegat

Artikel
11/26/2008

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

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

Syntax

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

public delegate void InkCollectorCursorButtonDownEventHandler(
    Object sender,
    InkCollectorCursorButtonDownEventArgs e
)

public delegate void InkCollectorCursorButtonDownEventHandler(
    Object^ sender, 
    InkCollectorCursorButtonDownEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorButtonDownEventHandler(
    Object sender,
    InkCollectorCursorButtonDownEventArgs e
)

JScript unterstützt keine Delegaten.

Parameter

sender
Typ: System.Object
Das InkCollector-Quellobjekt für dieses Ereignis.

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

Hinweise

Eine Taste an der Stiftspitze ist gedrückt, wenn der Benutzer den Stift auf den Digitizer absenkt und einen Strich zeichnet. Eine Taste am Stiftschaft ist aktiviert, wenn die Taste gedrückt ist.

Beim Erstellen eines InkCollectorCursorButtonDownEventHandler-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 drücken, erhalten Sie tatsächlich zwei CursorButtonDown-Ereignisse – eines, wenn die rechte Taste gedrückt ist, und eines, wenn die linke Taste 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.