InkAnalyzer.AddStrokes-Methode (Strokes, Int32)

Artikel
10/28/2008

Fügt InkAnalyzer eine Auflistung von Strichen hinzu und weist jedem Strich einen bestimmten Gebietsschemabezeichner zu.

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

Syntax

'Declaration
Public Function AddStrokes ( _
    strokesToAdd As Strokes, _
    languageId As Integer _
) As ContextNode
'Usage
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

Parameter

strokesToAdd
Typ: Microsoft.Ink.Strokes
Die Strokes, die InkAnalyzer hinzugefügt werden sollen.

languageId
Typ: System.Int32
Der Sprachbezeichner, der den Strichen in der strokesToAdd-Auflistung zugewiesen werden soll.

Rückgabewert

Typ: Microsoft.Ink.ContextNode
Der ContextNode, dem strokesToAdd hinzugefügt wurde.

Hinweise

InkAnalyzer fügt die Strokes einem UnclassifiedInkNode in der SubNodes-Auflistung der RootNode-Eigenschaft hinzu. Jedem Strich in der Strokes-Auflistung (strokesToAdd) wird der Gebietsschemabezeichner languageId zugewiesen, und alle werden dem ersten UnclassifiedInkNode hinzugefügt, der Striche mit demselben Gebietsschemabezeichner enthält. Wenn kein solcher UnclassifiedInkNode vorhanden ist, wird ein neuer UnclassifiedInkNode erstellt, und strokeToAdd wird dem neuen UnclassifiedInkNode hinzugefügt.

Diese Methode erweitert die DirtyRegion auf die Gesamtmenge des aktuellen Werts des Bereichs und des umgebenden Felds für die hinzugefügten Striche.

Wenn einige der Striche bereits an InkAnalyzer angefügt sind, löst InkAnalyzer eine Ausnahme aus.

Beispiele

In diesem Beispiel wird Folgendes ausgeführt.

Initialisiert ein neues Microsoft.Ink.Ink-Objekt, theInk.
Fügt einen Ink.InkAdded-Ereignishandler, theInk_InkAdded2, an theInk an.
Initialisiert einen neuen InkAnalyzer, theInkAnalyzer, der Strichdaten aus theInk analysieren kann.

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

In diesem Beispiel nimmt der theInk_InkAdded2-Ereignishandler dann die Striche, die theInk hinzugefügt wurden, fügt sie theInkAnalyzer hinzu und weist ihnen einen bestimmten Gebietsschemabezeichner (theLanguageId) zu.

''' <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);
}

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.