Ink.InkDeleted, événement

Article
11/05/2008

Mise à jour : November 2007

Se produit lorsqu'un objet Stroke est supprimé de l'objet Ink.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Event InkDeleted As StrokesEventHandler
'Utilisation
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 ne prend pas en charge les événements.

Notes

Le gestionnaire d'événements reçoit un argument de type StrokesEventArgs qui contient des données concernant cet événement.

Lorsque vous créez un délégué StrokesEventHandler, vous identifiez la méthode qui gère l'événement. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement. Le gestionnaire d'événements est appelé chaque fois qu'un événement se produit, sauf si vous supprimez le délégué.

Si vous utilisez l'objet InkOverlay ou le contrôle InkPicture (où EditingMode est égal à Delete et EraserMode est égal à StrokeErase) et que vous passez la gomme sur un trait, la séquence suivante d'événements se produit :

InkDeleted
InkAdded
InkDeleted

Les événements supplémentaires InkAdded et InkDeleted se produisent parce que le code sous-jacent ajoute un trait interne et invisible pour suivre la gomme.

L'événement InkDeleted se déclenche même en mode de sélection, et pas uniquement en mode de suppression. Vous devez surveiller le mode de modification (que vous êtes chargé de définir) et connaître le mode avant d'interpréter l'événement. Ces conditions offrent une plus grande liberté d'innovation sur la plateforme grâce à une sensibilité accrue des événements de plateforme.

Exemples

Dans cet exemple, un gestionnaire d'événements InkDeleted écrit des informations à propos des traits supprimés dans un contrôle ListBox.

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

        }
    }
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.