InkCollectorCursorInRangeEventArgs.NewCursor-Eigenschaft

Artikel
10/28/2008

Ruft einen booleschen Wert ab, der angibt, ob dies das erste Mal ist, dass das InkCollector-Objekt mit dem Cursor-Objekt in Kontakt gekommen ist, das das CursorInRange-Ereignis erzeugt hat.

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

Syntax

'Declaration
Public ReadOnly Property NewCursor As Boolean
'Usage
Dim instance As InkCollectorCursorInRangeEventArgs
Dim value As Boolean

value = instance.NewCursor

public bool NewCursor { get; }

public:
property bool NewCursor {
    bool get ();
}

/** @property */
public boolean get_NewCursor()

public function get NewCursor () : boolean

Eigenschaftenwert

Typ: System.Boolean
Gibt an, ob dies das erste Mal ist, dass das InkCollector-Objekt mit dem Cursor-Objekt in Kontakt gekommen ist, das das CursorInRange-Ereignis erzeugt hat.

Wert	Bedeutung
true	Dies ist das erste Mal, dass das InkCollector-Objekt mit diesem Cursor-Objekt in Kontakt gekommen ist.
false	Dieser InkCollector ist bereits zuvor mit diesem Cursor-Objekt in Kontakt gekommen.

Beispiele

In diesem Beispiel wird überprüft, ob das InkCollector-Objekt zum ersten Mal Kontakt mit diesem Cursor-Objekt hat, wenn das CursorInRange-Ereignis ausgelöst wird. 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.

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;
        }
    }
}

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.