Ink.InkAdded (Evento)

Artículo
10/28/2008

Actualización: noviembre 2007

Se produce cuando se agrega un objeto Stroke al objeto Ink.

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

Sintaxis

'Declaración
Public Event InkAdded As StrokesEventHandler
'Uso
Dim instance As Ink
Dim handler As StrokesEventHandler

AddHandler instance.InkAdded, handler

public event StrokesEventHandler InkAdded

public:
 event StrokesEventHandler^ InkAdded {
    void add (StrokesEventHandler^ value);
    void remove (StrokesEventHandler^ value);
}

/** @event */
public void add_InkAdded (StrokesEventHandler value)
/** @event */
public void remove_InkAdded (StrokesEventHandler value)

JScript no admite eventos.

Comentarios

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

Cuando se crea un delegado de StrokesEventHandler, 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.

Si usa el objeto InkOverlay o el control InkPicture (donde EditingMode es igual a Delete y EraserMode es igual a StrokeErase) y pasa el borrador sobre un trazo, se produce la siguiente secuencia de eventos:

Los eventos InkDeleted y InkAdded adicionales se producen porque el código subyacente agrega un trazo interno e invisible para realizar el seguimiento del borrador.

El evento InkAdded se desencadena incluso cuando se está en modo de selección o borrado, no sólo cuando se está en 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, un controlador de eventos InkAdded escribe información sobre los trazos agregados a un control de cuadro de lista.

Private Sub Ink_InkAdded(ByVal sender As Object, ByVal e As StrokesEventArgs)
    ' since this event fires in all modes, we will check EditingMode
    ' and examine the StrokeIds only if we are currently in mode: InkOverlayEditingMode.Ink 
    If InkOverlayEditingMode.Ink = Me.mInkOverlay.EditingMode Then
        For Each id As Integer In e.StrokeIds
            Me.listBoxStrokeId.Items.Add("Added ID:" + id.ToString())
        Next
    End If
End Sub

private void Ink_InkAdded(object sender, StrokesEventArgs e)
{
    // since this event fires in all modes, we will check EditingMode
    // and examine the StrokeIds only if we are currently in mode: InkOverlayEditingMode.Ink 
    if (InkOverlayEditingMode.Ink == this.mInkOverlay.EditingMode)
    {
        foreach (int id in e.StrokeIds)
        {
            this.listBoxStrokeId.Items.Add("Added ID:" + id.ToString());

        }
    }
}

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.