Delegato InkCollectorCursorButtonDownEventHandler

Articolo
10/29/2008

Aggiornamento: novembre 2007

Rappresenta il metodo che gestisce l'evento CursorButtonDown di un oggetto InkCollector.

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

Sintassi

'Dichiarazione
Public Delegate Sub InkCollectorCursorButtonDownEventHandler ( _
    sender As Object, _
    e As InkCollectorCursorButtonDownEventArgs _
)
'Utilizzo
Dim instance As New InkCollectorCursorButtonDownEventHandler(AddressOf HandlerMethod)

public delegate void InkCollectorCursorButtonDownEventHandler(
    Object sender,
    InkCollectorCursorButtonDownEventArgs e
)

public delegate void InkCollectorCursorButtonDownEventHandler(
    Object^ sender, 
    InkCollectorCursorButtonDownEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorButtonDownEventHandler(
    Object sender,
    InkCollectorCursorButtonDownEventArgs e
)

JScript non supporta i delegati.

Parametri

sender
Tipo: System.Object
Oggetto InkCollector di origine per questo evento.

e
Tipo: Microsoft.Ink.InkCollectorCursorButtonDownEventArgs
Oggetto InkCollectorCursorButtonDownEventArgs che contiene i dati dell'evento.

Note

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

Quando si crea un delegato InkCollectorCursorButtonDownEventHandler, si identifica 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 nel codice gestito se si aggiunge un gestore dell'evento.

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 eseguito 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 viene garantito che l'accesso successivo alla proprietà DrawingAttributes non generi 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.