InkAnalyzer.AddStroke-Methode (Stroke)

Artikel
11/26/2008

Fügt InkAnalyzer einen Stroke hinzu und weist dem Strich den Gebietsschemabezeichner des aktiven Eingabethreads zu.

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

Syntax

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

returnValue = instance.AddStroke(strokeToAdd)

public ContextNode AddStroke(
    Stroke strokeToAdd
)

public:
ContextNode^ AddStroke(
    Stroke^ strokeToAdd
)

public ContextNode AddStroke(
    Stroke strokeToAdd
)

public function AddStroke(
    strokeToAdd : Stroke
) : ContextNode

Parameter

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

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 der Gebietsschemabezeichner des aktiven Eingabethreads zugewiesen und 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 eine 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 fügt der theInkCollector_Stroke-Ereignishandler dann den Strich, der theInkCollector hinzugefügt wurde, theInkAnalyzer hinzu.

''' <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_Stroke( _
    ByVal sender As Object, ByVal e As Microsoft.Ink.InkCollectorStrokeEventArgs)

    ' Add the new stroke to the InkAnalyzer.
    Me.theInkAnalyzer.AddStroke(e.Stroke)

End Sub 'theInkCollector_Stroke

/// <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_Stroke(
    object sender, Microsoft.Ink.InkCollectorStrokeEventArgs e)
{
    // Add the new stroke to the InkAnalyzer.
    this.theInkAnalyzer.AddStroke(e.Stroke);
}

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.