Ink.InkDeleted-Ereignis

Artikel
11/26/2008

Tritt ein, wenn ein Stroke-Objekt aus dem Ink-Objekt gelöscht wird.

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

Syntax

'Declaration
Public Event InkDeleted As StrokesEventHandler
'Usage
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 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, erhalten Sie folgende Ereignisfolge:

InkDeleted
InkAdded
InkDeleted

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 InkDeleted-Ereignis wird selbst im Auswahlmodus ausgelöst, nicht nur im Löschmodus. 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 InkDeleted-Ereignishandler Informationen über die gelöschten Striche in ein Listenfeld-Steuerelement geschrieben.

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

        }
    }
}

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.