Evento InkCollector.CursorButtonUp

Articolo
10/29/2008

Aggiornamento: novembre 2007

Si verifica quando l'oggetto InkCollector rileva un oggetto CursorButton sollevato.

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

Sintassi

'Dichiarazione
Public Event CursorButtonUp As InkCollectorCursorButtonUpEventHandler
'Utilizzo
Dim instance As InkCollector
Dim handler As InkCollectorCursorButtonUpEventHandler

AddHandler instance.CursorButtonUp, handler

public event InkCollectorCursorButtonUpEventHandler CursorButtonUp

public:
 event InkCollectorCursorButtonUpEventHandler^ CursorButtonUp {
    void add (InkCollectorCursorButtonUpEventHandler^ value);
    void remove (InkCollectorCursorButtonUpEventHandler^ value);
}

/** @event */
public void add_CursorButtonUp (InkCollectorCursorButtonUpEventHandler value)
/** @event */
public void remove_CursorButtonUp (InkCollectorCursorButtonUpEventHandler value)

JScript non supporta gli eventi.

Note

Un pulsante sulla punta di una penna è sollevato quando l'utente completa un tratto e solleva la penna dal digitalizzatore. Un pulsante su un cannello è sollevato quando non viene premuto.

Il gestore eventi riceve un argomento di tipo InkCollectorCursorButtonUpEventArgs contenente i dati relativi a questo evento.

Quando si crea un delegato InkCollectorCursorButtonUpEventHandler, viene identificato il metodo che gestisce l'evento. Per associare l'evento al gestore eventi in uso, aggiungere all'evento un'istanza del delegato. Il gestore eventi viene chiamato ogni volta che si verifica l'evento, a meno che non si rimuova il delegato. Per motivi di prestazioni, l'interesse dell'evento predefinito è disattivato, ma viene attivato automaticamente se si aggiunge un gestore eventi.

Quando si rilascia il pulsante destro del mouse, si ricevono in effetti due eventi CursorButtonUp, uno per il pulsante destro sollevato e uno per il pulsante sinistro sollevato.

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.