Evento InkPicture.CursorButtonDown

Articolo
10/29/2008

Aggiornamento: novembre 2007

Si verifica quando il controllo InkPicture rileva un oggetto CursorButton abbassato.

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

Sintassi

'Dichiarazione
Public Event CursorButtonDown As InkCollectorCursorButtonDownEventHandler
'Utilizzo
Dim instance As InkPicture
Dim handler As InkCollectorCursorButtonDownEventHandler

AddHandler instance.CursorButtonDown, handler

public event InkCollectorCursorButtonDownEventHandler CursorButtonDown

public:
 event InkCollectorCursorButtonDownEventHandler^ CursorButtonDown {
    void add (InkCollectorCursorButtonDownEventHandler^ value);
    void remove (InkCollectorCursorButtonDownEventHandler^ value);
}

/** @event */
public void add_CursorButtonDown (InkCollectorCursorButtonDownEventHandler value)
/** @event */
public void remove_CursorButtonDown (InkCollectorCursorButtonDownEventHandler value)

JScript non supporta gli eventi.

Note

Un pulsante sulla punta di una penna è abbassato quando l'utente posiziona la penna sul digitalizzatore e inizia a tracciare un tratto. Un pulsante su una penna è abbassato quando è premuto.

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

Quando si crea un delegato InkCollectorCursorButtonDownEventHandler, viene identificato il metodo che gestisce l'evento. Per associare l'evento al gestore in uso, aggiungere all'evento un'istanza del delegato. Il gestore dell'evento 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 preme il pulsante destro del mouse, si ricevono due eventi CursorButtonDown, uno per il pulsante destro premuto e uno per il pulsante sinistro premuto.

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 InkPicture 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.