Delegato InkCollectorCursorOutOfRangeEventHandler

Articolo
10/29/2008

Aggiornamento: novembre 2007

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

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

Sintassi

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

public delegate void InkCollectorCursorOutOfRangeEventHandler(
    Object sender,
    InkCollectorCursorOutOfRangeEventArgs e
)

public delegate void InkCollectorCursorOutOfRangeEventHandler(
    Object^ sender, 
    InkCollectorCursorOutOfRangeEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorOutOfRangeEventHandler(
    Object sender,
    InkCollectorCursorOutOfRangeEventArgs e
)

JScript non supporta i delegati.

Parametri

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

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

Note

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.