InkAnalyzer.AddStroke-Methode (Stroke, Int32)

Artikel
11/26/2008

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

Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.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: System.Windows.Ink.Stroke
Der InkAnalyzer hinzuzufügende Stroke.

languageId
Typ: System.Int32
Der strokeToAdd zugewiesene Gebietsschemabezeichner.

Rückgabewert

Typ: System.Windows.Ink.ContextNode
Der ContextNode, dem strokeToAdd hinzugefügt wird.

Hinweise

Der InkAnalyzer fügt die Stroke einem UnclassifiedInkNode in der SubNodes-Auflistung der RootNode-Eigenschaft hinzu. Stroke, strokeToAdd wird der Gebietsschemabezeichner, languageId., zugewiesen. Stroke 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 die DirtyRegion auf die Gesamtmenge des aktuellen Werts des Bereichs und des umgebenden Rechtecks 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.

Ein neues InkCollector-Objekt, theInkCollector., wird initialisiert.
Fügt einen InkCollectorStroke()-Ereignishandler mit dem Namen theInkCollector_Stroke an theInkCollector. an.

Initialisiert einen neuen InkAnalyzer mit dem Namen theInkAnalyzer, der vom Ink()-Objekt des InkCollector Objekts erhaltene Strichdaten analysiert.

' Create the InkAnalyzer.
theInkAnalyzer = New InkAnalyzer()

' Attach an event handler to the InkCanvas.StrokeCollected event.
AddHandler theInkCanvas.StrokeCollected, AddressOf InkArea_StrokeCollected

// Create the InkAnalyzer.
theInkAnalyzer = new InkAnalyzer();

// Attach an event handler to the InkCanvas.StrokeCollected event.
theInkCanvas.StrokeCollected += 
    new InkCanvasStrokeCollectedEventHandler(InkArea_StrokeCollected);

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 spezifischen Gebietsschemabezeichner namens theLanguageId zu.

Sub InkCamvas_StrokeCollected(ByVal sender As Object, ByVal e As InkCanvasStrokeCollectedEventArgs)
    theInkAnalyzer.AddStroke(e.Stroke, Me.theLangageId)

End Sub 'InkCamvas_StrokeCollected

void InkCamvas_StrokeCollected(object sender, InkCanvasStrokeCollectedEventArgs e)
{
    theInkAnalyzer.AddStroke(e.Stroke, this.theLangageId);
}

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.