Evento InkOverlay.CursorOutOfRange

Articolo
10/29/2008

Aggiornamento: novembre 2007

Si verifica quando un cursore esce dall'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 CursorOutOfRange As InkCollectorCursorOutOfRangeEventHandler
'Utilizzo
Dim instance As InkOverlay
Dim handler As InkCollectorCursorOutOfRangeEventHandler

AddHandler instance.CursorOutOfRange, handler

public event InkCollectorCursorOutOfRangeEventHandler CursorOutOfRange

public:
 event InkCollectorCursorOutOfRangeEventHandler^ CursorOutOfRange {
    void add (InkCollectorCursorOutOfRangeEventHandler^ value);
    void remove (InkCollectorCursorOutOfRangeEventHandler^ value);
}

/** @event */
public void add_CursorOutOfRange (InkCollectorCursorOutOfRangeEventHandler value)
/** @event */
public void remove_CursorOutOfRange (InkCollectorCursorOutOfRangeEventHandler value)

JScript non supporta gli eventi.

Note

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

Quando si crea un delegato InkCollectorCursorOutOfRangeEventHandler, 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 CursorOutOfRange 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 CursorOutOfRange, il colore dell'ultimo tratto da creare viene modificato in rosso.

Private Sub mInkObject_CursorOutOfRange(ByVal sender As Object, ByVal e As InkCollectorCursorOutOfRangeEventArgs)
    Using s As Strokes = mInkObject.Ink.Strokes
        If s.Count > 0 Then
            s(s.Count - 1).DrawingAttributes.Color = Color.Tomato
            ' redraw the ink canvas
            panelInkCanvas.Invalidate()
        End If
    End Using
End Sub

private void mInkObject_CursorOutOfRange(object sender, InkCollectorCursorOutOfRangeEventArgs e)
{
    using (Strokes S = mInkObject.Ink.Strokes)
    {
        if (S.Count > 0)
        {
            S[S.Count - 1].DrawingAttributes.Color = Color.Tomato;
            // redraw the ink canvas
            panelInkCanvas.Invalidate();
        }
    }
}

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.