Proprietà InkCollectorCursorButtonUpEventArgs.Cursor

Articolo
10/29/2008

Aggiornamento: novembre 2007

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

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

Sintassi

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

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 puntamento e selezione del Tablet PC, di solito 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, 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. Se il mouse è in uso, 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 effettuato 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 effettuato 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.