InkAnalyzer.AddStrokes, méthode (Strokes)

Article
11/05/2008

Mise à jour : November 2007

Ajoute une collection de traits à l'InkAnalyzer et assigne l'identificateur de paramètres régionaux du thread d'entrée actif à chaque trait.

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

Syntaxe

'Déclaration
Public Function AddStrokes ( _
    strokesToAdd As Strokes _
) As ContextNode
'Utilisation
Dim instance As InkAnalyzer
Dim strokesToAdd As Strokes
Dim returnValue As ContextNode

returnValue = instance.AddStrokes(strokesToAdd)

public ContextNode AddStrokes(
    Strokes strokesToAdd
)

public:
ContextNode^ AddStrokes(
    Strokes^ strokesToAdd
)

public ContextNode AddStrokes(
    Strokes strokesToAdd
)

public function AddStrokes(
    strokesToAdd : Strokes
) : ContextNode

Paramètres

strokesToAdd
Type : Microsoft.Ink.Strokes
Strokes à ajouter au InkAnalyzer.

Valeur de retour

Type : Microsoft.Ink.ContextNode
ContextNode auquel strokesToAdd a été ajouté.

Notes

InkAnalyzer ajoute le Strokes à un UnclassifiedInkNode dans la collection SubNodes de la propriété RootNode. L'identificateur de paramètres régionaux du thread d'entrée actif est assigné à chaque trait de la collection Strokes, strokesToAdd, et celui-ci est ajouté au premier UnclassifiedInkNode contenant des traits possédant le même identificateur de paramètres régionaux. Si aucun UnclassifiedInkNode correspondant n'existe, un UnclassifiedInkNode est créé et strokeToAdd est ajouté au nouveau UnclassifiedInkNode.

Cette méthode étend la propriété DirtyRegion à l'union de la valeur actuelle de la région et du cadre englobant des traits ajoutés.

Si l'un de ces traits est déjà attaché au InkAnalyzer, le InkAnalyzer lève une exception.

Exemples

Cet exemple effectue les actions suivantes.

Initialise un nouvel objet Microsoft.Ink.Ink, theInk.
Attache un gestionnaire d'événements Ink.InkAdded, theInk_InkAdded, à theInk
Initialise un nouvel InkAnalyzer, theInkAnalyzer qui peut analyser les données de trait à partir de theInk.

' Create the Ink for use with the InkCollector and attach
' event handlers.
Me.theInk = New Microsoft.Ink.Ink()
AddHandler Me.theInk.InkAdded, AddressOf theInk_InkAdded

' Create the InkAnalyzer.
Me.theInkAnalyzer = New Microsoft.Ink.InkAnalyzer(Me.theInk, Me)

// Create the Ink for use with the InkCollector and attach
// event handlers.
this.theInk = new Microsoft.Ink.Ink();
this.theInk.InkAdded +=
    new Microsoft.Ink.StrokesEventHandler(theInk_InkAdded);

// Create the InkAnalyzer.
this.theInkAnalyzer =
    new Microsoft.Ink.InkAnalyzer(this.theInk, this);

Dans cet exemple, le gestionnaire d'événements theInk_InkAdded prend ensuite les traits qui ont été ajoutés à theInk et les ajoute à theInkAnalyzer.

''' <summary>
''' The ink's InkAdded event handler.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
Sub theInk_InkAdded( _
    ByVal sender As Object, ByVal e As Microsoft.Ink.StrokesEventArgs)

    ' This event handler is attached to an Ink object.
    Dim theInk As Microsoft.Ink.Ink = DirectCast(sender, Microsoft.Ink.Ink)

    ' Add the new strokes to the InkAnalyzer.
    Me.theInkAnalyzer.AddStrokes(theInk.CreateStrokes(e.StrokeIds))

End Sub 'theInk_InkAdded

/// <summary>
/// The ink's InkAdded event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
void theInk_InkAdded(object sender, Microsoft.Ink.StrokesEventArgs e)
{
    // This event handler is attached to an Ink object.
    Microsoft.Ink.Ink theInk = sender as Microsoft.Ink.Ink;

    // Add the new strokes to the InkAnalyzer.
    this.theInkAnalyzer.AddStrokes(theInk.CreateStrokes(e.StrokeIds));
}

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.