Evento Ink.InkDeleted

Articolo
10/29/2008

Aggiornamento: novembre 2007

Si verifica quando un oggetto Stroke viene eliminato dall'oggetto Ink.

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

Sintassi

'Dichiarazione
Public Event InkDeleted As StrokesEventHandler
'Utilizzo
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 non supporta gli eventi.

Note

Il gestore eventi riceve un argomento di tipo StrokesEventArgs contenente i dati relativi a questo evento.

Quando si crea un delegato StrokesEventHandler, si identifica il metodo che gestisce l'evento. Per associare l'evento al gestore eventi 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 venga rimosso il delegato.

Se si utilizza l'oggetto InkOverlay o il controllo InkPicture (dove EditingMode è uguale a Delete e EraserMode è uguale a StrokeErase) e si passa la gomma su un tratto, si ottiene la sequenza di eventi riportata di seguito.

InkDeleted
InkAdded
InkDeleted

Vengono generati gli eventi InkAdded e InkDeleted aggiuntivi in quanto il codice sottostante aggiunge un tratto interno, invisibile per registrare la gomma.

L'evento InkDeleted viene generato anche quando nella modalità di selezione, non solo in caso di modalità di eliminazione. È 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, un gestore eventi InkDeleted scrive le informazioni sui tratti eliminati in un controllo della casella di riepilogo.

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

        }
    }
}

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.