InkOverlay.CursorButtonDown-Ereignis

Artikel
11/26/2008

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

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

Syntax

'Declaration
Public Event CursorButtonDown As InkCollectorCursorButtonDownEventHandler
'Usage
Dim instance As InkOverlay
Dim handler As InkCollectorCursorButtonDownEventHandler

AddHandler instance.CursorButtonDown, handler

public event InkCollectorCursorButtonDownEventHandler CursorButtonDown

public:
 event InkCollectorCursorButtonDownEventHandler^ CursorButtonDown {
    void add (InkCollectorCursorButtonDownEventHandler^ value);
    void remove (InkCollectorCursorButtonDownEventHandler^ value);
}

/** @event */
public void add_CursorButtonDown (InkCollectorCursorButtonDownEventHandler value)
/** @event */
public void remove_CursorButtonDown (InkCollectorCursorButtonDownEventHandler value)

JScript unterstützt keine Ereignisse.

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 Schaft ist aktiviert, wenn die Taste gedrückt ist.

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

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 aktiviert, wenn Sie einen Ereignishandler hinzufügen.

Wenn Sie die rechte Maustaste drücken, erhalten Sie 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 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.