InkAnalyzer.AddStroke-Methode (Stroke, Int32)

Artikel
10/28/2008

Fügt InkAnalyzer einen Strich hinzu und weist dem Strich einen bestimmten Gebietsschemabezeichner zu.

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

Syntax

'Declaration
Public Function AddStroke ( _
    strokeToAdd As Stroke, _
    languageId As Integer _
) As ContextNode
'Usage
Dim instance As InkAnalyzer
Dim strokeToAdd As Stroke
Dim languageId As Integer
Dim returnValue As ContextNode

returnValue = instance.AddStroke(strokeToAdd, _
    languageId)

public ContextNode AddStroke(
    Stroke strokeToAdd,
    int languageId
)

public:
ContextNode^ AddStroke(
    Stroke^ strokeToAdd, 
    int languageId
)

public ContextNode AddStroke(
    Stroke strokeToAdd,
    int languageId
)

public function AddStroke(
    strokeToAdd : Stroke, 
    languageId : int
) : ContextNode

Parameter

strokeToAdd
Typ: Microsoft.Ink.Stroke
Der Stroke, der InkAnalyzer hinzugefügt werden soll.

languageId
Typ: System.Int32
Der strokeToAdd zuzuweisende Gebietsschemabezeichner

Rückgabewert

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

Hinweise

Der InkAnalyzer fügt den Stroke einem UnclassifiedInkNode in der SubNodes-Auflistung der RootNode-Eigenschaft hinzu. Stroke (strokeToAdd) wird dem Gebietsschemabezeichner languageId zugewiesen und wird 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 DirtyRegion auf die Gesamtmenge des aktuellen Werts des Bereichs und des umgebenden Felds für den hinzugefügten Strich.

Wenn der Strich bereits an InkAnalyzer angefügt ist, löst InkAnalyzer eine Ausnahme aus.

Beispiele

In diesem Beispiel wird Folgendes ausgeführt.

Initialisiert ein neues Microsoft.Ink.InkCollector-Objekt namens theInkCollector.
Fügt einen InkCollector.Stroke-Ereignishandler, theInkCollector_Stroke, an theInkCollector an.
Initialisiert einen neuen InkAnalyzer, theInkAnalyzer, der Strichdaten der Ink-Eigenschaft des InkCollector-Objekts analysieren kann.

' Create and enable the InkCollector and attach event handlers.
Me.theInkCollector = New Microsoft.Ink.InkCollector(Me.theInkingPanel)
AddHandler Me.theInkCollector.Stroke, AddressOf Me.theInkCollector_Stroke
Me.theInkCollector.Enabled = True

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

// Create and enable the InkCollector and attach event handlers.
this.theInkCollector =
    new Microsoft.Ink.InkCollector(this.theInkingPanel);
this.theInkCollector.Stroke +=
    new Microsoft.Ink.InkCollectorStrokeEventHandler(
        this.theInkCollector_Stroke);
this.theInkCollector.Enabled = true;

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

In diesem Beispiel nimmt der theInkCollector_Stroke-Ereignishandler dann den Strich, der theInkCollector hinzugefügt wurde, fügt ihn theInkAnalyzer hinzu und weist ihm einen bestimmten Gebietsschemabezeichner (theLanguageId) zu.

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

    ' Add the new stroke to the InkAnalyzer using a specific language identifier.
    Me.theInkAnalyzer.AddStroke(e.Stroke, Me.theLanguageId)

End Sub 'theInkCollector_Stroke2

/// <summary>
/// The ink collector's Stroke event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
void theInkCollector_Stroke2(
    object sender, Microsoft.Ink.InkCollectorStrokeEventArgs e)
{
    // Add the new stroke to the InkAnalyzer using a specific
    // language identifier.
    this.theInkAnalyzer.AddStroke(e.Stroke, 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.