Proprietà InkCollectorCursorInRangeEventArgs.NewCursor

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene un valore booleano che indica se si tratta della prima volta che questo oggetto InkCollector entra in contatto con l'oggetto Cursor che ha generato l'evento CursorInRange.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public ReadOnly Property NewCursor As Boolean
'Utilizzo
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

Valore proprietà

Tipo: System.Boolean
Se si tratta della prima volta che questo oggetto InkCollector entra in contatto con l'oggetto Cursor che ha generato l'evento CursorInRange.

Valore	Significato
true	Si tratta della prima volta che questo oggetto InkCollector entra in contatto con questo oggetto Cursor.
false	Questo oggetto InkCollector è già entrato in contatto con questo oggetto Cursor.

Esempi

In questo esempio quando viene generato l'evento CursorInRange, viene effettuato un controllo per verificare se è la prima volta che l'oggetto InkCollector entra in contatto con questo particolare oggetto Cursor. In questo caso, la proprietà DrawingAttributes viene assegnata con un clone della proprietà DefaultDrawingAttributes. In questo modo viene garantito che l'accesso successivo alla proprietà DrawingAttributes non generi un'eccezione di riferimento null.

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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.