Ink.InkAdded, événement

Article
11/05/2008

Mise à jour : November 2007

Se produit lorsqu'un objet Stroke est ajouté à l'objet Ink.

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

Syntaxe

'Déclaration
Public Event InkAdded As StrokesEventHandler
'Utilisation
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 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 :

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 InkAdded se déclenche en mode de sélection ou d'effacement, et pas uniquement lors de l'insertion d'une entrée manuscrite. 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 InkAdded écrit des informations à propos des traits ajoutés à un contrôle Listbox.

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

        }
    }
}

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.