Evento Ink.InkAdded

Articolo
10/29/2008

Aggiornamento: novembre 2007

Si verifica quando un oggetto Stroke viene aggiunto all'oggetto Ink.

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

Sintassi

'Dichiarazione
Public Event InkAdded As StrokesEventHandler
'Utilizzo
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 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 verifica la sequenza di eventi riportata di seguito.

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

L'evento InkAdded viene generato anche quando nella modalità di selezione o di gomma, non solo in caso di inserimento di input penna. È 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 InkAdded scrive le informazioni sui tratti aggiunti in un controllo della casella di riepilogo.

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

        }
    }
}

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.