Proprietà InkCollectorCursorButtonDownEventArgs.Cursor

Aggiornamento: novembre 2007

Ottiene l'oggetto Cursor che ha generato l'evento CursorButtonDown.

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

Sintassi

'Dichiarazione
Public ReadOnly Property Cursor As Cursor
'Utilizzo
Dim instance As InkCollectorCursorButtonDownEventArgs
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

Valore proprietà

Tipo: Microsoft.Ink.Cursor
Oggetto che ha generato l'evento CursorButtonDown.

Note

La classe Microsoft.Ink.Cursor non deve essere confusa con la classe System.Windows.Forms.Cursor. Microsoft.Ink.Cursor rappresenta le informazioni generali su un dispositivo di selezione e puntamento del Tablet PC, in genere una penna, mentre System.Windows.Forms.Cursor rappresenta l'immagine utilizzata per disegnare il puntatore del mouse.

Esempi

Nell'esempio seguente viene illustrato come sottoscrivere gli eventi CursorInRange, CursorButtonDown e CursorButtonUp allo scopo di visualizzare il puntatore dell'input penna (quando si utilizza il mouse per l'input penna) in un colore diverso dall'input penna stesso.

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, alla proprietà DrawingAttributes viene assegnato un clone della proprietà DefaultDrawingAttributes. In questo modo si garantisce che l'accesso successivo alla proprietà DrawingAttributes non genererà un'eccezione dovuta a un riferimento null. Se si utilizza il mouse, il colore dell'input penna viene impostato sul rosso.

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

Quando viene generato l'evento CursorButtonDown, viene eseguito un controllo per verificare se l'oggetto Cursor fornito all'evento è il mouse. In questo caso, la proprietà Color() viene impostata sul colore blu.

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

}

Quando viene generato l'evento CursorButtonUp, viene eseguito un controllo per verificare se l'oggetto Cursor fornito all'evento è il mouse. In questo caso, la proprietà Color() viene nuovamente impostata sul colore rosso.

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

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.