InkCollectorCursorOutOfRangeEventHandler (Delegado)

Artículo
11/26/2008

Actualización: noviembre 2007

Representa el método que controla el evento CursorOutOfRange de un objeto InkCollector.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Delegate Sub InkCollectorCursorOutOfRangeEventHandler ( _
    sender As Object, _
    e As InkCollectorCursorOutOfRangeEventArgs _
)
'Uso
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 no admite delegados.

Parámetros

sender
Tipo: System.Object
Objeto InkCollector de origen de este evento.

e
Tipo: Microsoft.Ink.InkCollectorCursorOutOfRangeEventArgs
Objeto InkCollectorCursorOutOfRangeEventArgs que contiene los datos del evento.

Comentarios

Cuando se crea un delegado de InkCollectorCursorOutOfRangeEventHandler, se identifica el método que controla el evento. Para asociarlo al controlador de eventos, se debe agregar al evento una instancia del delegado. Siempre que se produce el evento, se llama a su controlador, a menos que se quite el delegado. El interés del evento predeterminado está activado.

El evento CursorOutOfRange se desencadena incluso cuando se está en modo de selección o de borrado, no solo cuando se está en modo de entrada manuscrita. Esto requiere que supervise el modo de edición (que es responsable de configurar) y que preste atención a este modo antes de interpretar el evento. La ventaja de este requisito es que se tiene mayor libertad para innovar en la plataforma gracias a un mejor conocimiento de los eventos de la misma.

Ejemplos

En este ejemplo, cuando se desencadena el evento CursorOutOfRange, el color del último trazo que se va a crear se cambia a rojo.

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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.