Ink.InkAdded-Ereignis

Artikel
10/28/2008

Tritt ein, wenn dem Stroke-Objekt ein Ink-Objekt hinzugefügt wird.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Event InkAdded As StrokesEventHandler
'Usage
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 unterstützt keine Ereignisse.

Hinweise

Der Ereignishandler empfängt ein Argument vom Typ StrokesEventArgs, das Daten zu diesem Ereignis enthält.

Beim Erstellen eines StrokesEventHandler-Delegaten bestimmen Sie die Methode für die Ereignisbehandlung. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird.

Wenn Sie das InkOverlay-Objekt oder das InkPicture-Steuerelement verwenden (wobei EditingMode gleich Delete und EraserMode gleich StrokeErase ist) und den Radierer über einen Strich führen, tritt die folgende Ereignisfolge ein:

Das InkAdded-Ereignis und das InkDeleted-Ereignis treten zusätzlich ein, weil der zugrunde liegende Code einen internen unsichtbaren Strich zum Verfolgen des Radierers einfügt.

Das InkAdded-Ereignis wird auch im Auswahl- oder Löschmodus ausgelöst, nicht nur bei Freihandeingaben. Dies erfordert, dass Sie den Bearbeitungsmodus (den Sie festlegen müssen) überwachen und den Modus kennen, bevor Sie das Ereignis interpretieren. Der Vorteil dieser Anforderung besteht in einer größeren Flexibilität für Neuerungen auf der Plattform, da Plattformereignisse besser erkannt werden können.

Beispiele

In diesem Beispiel werden in einem InkAdded-Ereignishandler Informationen über die hinzugefügten Striche in ein Listenfeld-Steuerelement geschrieben.

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

        }
    }
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.