InkCollectorCursorInRangeEventArgs.NewCursor, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient une valeur booléenne qui indique si c'est la première fois que cet objet InkCollector est entré en contact avec l'objet Cursor qui a généré l'événement CursorInRange.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public ReadOnly Property NewCursor As Boolean
'Utilisation
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

Valeur de propriété

Type : System.Boolean
Si c'est la première fois que cet objet InkCollector est entré en contact avec l'objet Cursor qui a généré l'événement CursorInRange.

Valeur	Signification
true	C'est la première fois que cet objet InkCollector est entré en contact avec cet objet Cursor.
false	Ce InkCollector est déjà entré en contact avec ce Cursor.

Exemples

Dans cet exemple, lorsque l'événement CursorInRange se déclenche, un contrôle vérifie si c'est la première fois que l'objet InkCollector entre en contact avec cet objet Cursor spécifique. Si c'est le cas, un clone de la propriété DefaultDrawingAttributes est assigné à la propriété DrawingAttributes. Ainsi, lors de l'accès suivant à la propriété, DrawingAttributes aucune exception de référence null n'est levée.

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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.