InkCollector.CursorOutOfRange (Evento)

Artículo
11/26/2008

Actualización: noviembre 2007

Se produce cuando un cursor abandona el intervalo de detección físico (proximidad) del contexto de Tablet PC.

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

Sintaxis

'Declaración
Public Event CursorOutOfRange As InkCollectorCursorOutOfRangeEventHandler
'Uso
Dim instance As InkCollector
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 no admite eventos.

Comentarios

El controlador de eventos recibe un argumento de tipo InkCollectorCursorOutOfRangeEventArgs que contiene datos sobre este evento.

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 el modo de selección o de borrado, no solo cuando se está en el modo de entrada manuscrita. Esto requiere que supervise el modo de edición (de cuya configuración es responsable) 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 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.