InkCollectorCursorInRangeEventArgs.NewCursor (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene un valor booleano que indica si es la primera vez que este objeto InkCollector ha entrado en contacto con el objeto Cursor que generó el evento CursorInRange.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public ReadOnly Property NewCursor As Boolean
'Uso
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

Valor de propiedad

Tipo: System.Boolean
Indica si es la primera vez que este objeto InkCollector ha entrado en contacto con el objeto Cursor que generó el evento CursorInRange.

Valor	Significado
true	Es la primera vez este objeto InkCollector ha entrado en contacto con este objeto Cursor.
false	Este InkCollector ha entrado en contacto con este Cursor antes.

Ejemplos

En este ejemplo, cuando el evento CursorInRange se desencadena, se realiza una comprobación para evaluar si se trata de la primera vez que el objeto InkCollector ha entrado en contacto con este objeto Cursor específico. En caso afirmativo, a la propiedad DrawingAttributes se le asigna un clon de la propiedad DefaultDrawingAttributes. De este modo, se garantiza que el acceso posterior a la propiedad DrawingAttributes no desencadena una excepción de referencia nula.

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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.