Ink.InkDeleted (Evento)

Artículo
10/28/2008

Actualización: noviembre 2007

Se produce cuando un objeto Stroke se borra del objeto Ink.

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

Sintaxis

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

AddHandler instance.InkDeleted, handler

public event StrokesEventHandler InkDeleted

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

/** @event */
public void add_InkDeleted (StrokesEventHandler value)
/** @event */
public void remove_InkDeleted (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:

InkDeleted
InkAdded
InkDeleted

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 InkDeleted se desencadena incluso cuando si se está en modo de selección, no solo cuando se está en modo de eliminación. 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 InkDeleted escribe información sobre los trazos eliminados de un control de cuadro de lista.

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

private void Ink_InkDeleted(object sender, StrokesEventArgs e)
{
    // since this event fires in select mode also, we will check EditingMode
    // and examine the StrokeIds only if we are currently in mode: InkOverlayEditingMode.Delete 
    if (InkOverlayEditingMode.Delete == this.mInkOverlay.EditingMode)
    {
        foreach (int id in e.StrokeIds)
        {
            this.listBoxStrokeId.Items.Add("Deleted 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.