Evento InkOverlay.CursorInRange

Articolo
10/29/2008

Aggiornamento: novembre 2007

Si verifica quando un cursore entra nell'intervallo di rilevamento fisico (prossimità) del contesto della tavoletta.

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

Sintassi

'Dichiarazione
Public Event CursorInRange As InkCollectorCursorInRangeEventHandler
'Utilizzo
Dim instance As InkOverlay
Dim handler As InkCollectorCursorInRangeEventHandler

AddHandler instance.CursorInRange, handler

public event InkCollectorCursorInRangeEventHandler CursorInRange

public:
 event InkCollectorCursorInRangeEventHandler^ CursorInRange {
    void add (InkCollectorCursorInRangeEventHandler^ value);
    void remove (InkCollectorCursorInRangeEventHandler^ value);
}

/** @event */
public void add_CursorInRange (InkCollectorCursorInRangeEventHandler value)
/** @event */
public void remove_CursorInRange (InkCollectorCursorInRangeEventHandler value)

JScript non supporta gli eventi.

Note

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

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