InkCollectorCursorButtonUpEventArgs.Cursor-Eigenschaft

Artikel
11/26/2008

Ruft das Cursor-Objekt ab, das das CursorButtonUp-Ereignis generiert hat.

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

Syntax

'Declaration
Public ReadOnly Property Cursor As Cursor
'Usage
Dim instance As InkCollectorCursorButtonUpEventArgs
Dim value As Cursor

value = instance.Cursor

public Cursor Cursor { get; }

public:
property Cursor^ Cursor {
    Cursor^ get ();
}

/** @property */
public Cursor get_Cursor()

public function get Cursor () : Cursor

Eigenschaftenwert

Typ: Microsoft.Ink.Cursor
Das Objekt, das das CursorButtonUp-Ereignis generiert hat.

Hinweise

Die Microsoft.Ink.Cursor-Klasse darf nicht mit der System.Windows.Forms.Cursor-Klasse verwechselt werden. Microsoft.Ink.Cursor stellt allgemeine Informationen zu einem Tablettzeige- und -auswahlgerät (i. d. R. ein Stift) dar, während System.Windows.Forms.Cursor das Bild zum Zeichnen des Mauszeigers darstellt.

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.