InkAnalyzer.AddStrokes, méthode (Strokes, Int32)

Article
11/05/2008

Mise à jour : November 2007

Ajoute une collection de traits au InkAnalyzer et assigne un identificateur de paramètres régionaux spécifique à 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, _
    languageId As Integer _
) As ContextNode
'Utilisation
Dim instance As InkAnalyzer
Dim strokesToAdd As Strokes
Dim languageId As Integer
Dim returnValue As ContextNode

returnValue = instance.AddStrokes(strokesToAdd, _
    languageId)

public ContextNode AddStrokes(
    Strokes strokesToAdd,
    int languageId
)

public:
ContextNode^ AddStrokes(
    Strokes^ strokesToAdd, 
    int languageId
)

public ContextNode AddStrokes(
    Strokes strokesToAdd,
    int languageId
)

public function AddStrokes(
    strokesToAdd : Strokes, 
    languageId : int
) : ContextNode

Paramètres

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

languageId
Type : System.Int32
Identificateur de langue à assigner aux traits de la collection strokesToAdd.

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, languageId, 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_InkAdded2, à 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_InkAdded2 prend ensuite les traits qui ont été ajoutés à theInk, les ajoute à theInkAnalyzer et leur assigne un identificateur de paramètres régionaux spécifique, theLanguageId.

''' <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_InkAdded2( _
    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 using a specific language identifier.
    Me.theInkAnalyzer.AddStrokes( _
        theInk.CreateStrokes(e.StrokeIds), Me.theLanguageId)
End Sub 'theInk_InkAdded2

/// <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_InkAdded2(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 using a specific
    // language identifier.
    this.theInkAnalyzer.AddStrokes(
        theInk.CreateStrokes(e.StrokeIds), this.theLanguageId);
}

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.