Delegato InkCollectorCursorInRangeEventHandler

Articolo
10/29/2008

Aggiornamento: novembre 2007

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

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

Sintassi

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

public delegate void InkCollectorCursorInRangeEventHandler(
    Object sender,
    InkCollectorCursorInRangeEventArgs e
)

public delegate void InkCollectorCursorInRangeEventHandler(
    Object^ sender, 
    InkCollectorCursorInRangeEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorInRangeEventHandler(
    Object sender,
    InkCollectorCursorInRangeEventArgs e
)

JScript non supporta i delegati.

Parametri

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

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

Note

Quando si crea un delegato InkCollectorCursorInRangeEventHandler, 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 eventi viene chiamato ogni volta che si verifica l'evento, a meno che non si rimuova il delegato. L'interesse dell'evento predefinito è attivato.

L'evento CursorInRange viene generato anche nella modalità di selezione o di gomma, non solo nella modalità di input penna. È necessario monitorare la modalità di modifica (della cui impostazione è responsabile l'utente) ed essere consapevoli di tale modalità prima di interpretare l'evento. Il vantaggio di questo requisito è una maggiore libertà di innovazione della piattaforma grazie a una maggiore consapevolezza degli eventi della piattaforma.

Esempi

In questo esempio 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.

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

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.