InkAnalyzer.AddStrokes-Methode (StrokeCollection, Int32)

Artikel
11/26/2008

Fügt dem InkAnalyzer eine StrokeCollection hinzu und weist jedem Strich einen spezifischen Gebietsschemabezeichner zu.

Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)

Syntax

'Declaration
Public Function AddStrokes ( _
    strokesToAdd As StrokeCollection, _
    languageId As Integer _
) As ContextNode
'Usage
Dim instance As InkAnalyzer
Dim strokesToAdd As StrokeCollection
Dim languageId As Integer
Dim returnValue As ContextNode

returnValue = instance.AddStrokes(strokesToAdd, _
    languageId)

public ContextNode AddStrokes(
    StrokeCollection strokesToAdd,
    int languageId
)

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

public ContextNode AddStrokes(
    StrokeCollection strokesToAdd,
    int languageId
)

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

Parameter

strokesToAdd
Typ: System.Windows.Ink.StrokeCollection
Die InkAnalyzer hinzuzufügende StrokeCollection.

languageId
Typ: System.Int32
Der Gebietsschemabezeichner, der den Strichen in der strokesToAdd-Auflistung zugewiesen wurde.

Rückgabewert

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

Hinweise

Der InkAnalyzer fügt die StrokeCollection einem UnclassifiedInkNode in der SubNodes-Auflistung der RootNode-Eigenschaft hinzu. Jedem Strich in der StrokeCollection-Auflistung (strokesToAdd) wird der Gebietsschemabezeichner languageId 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 strokesToAdd 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 die hinzugefügten Striche.

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

Beispiele

Im folgenden Beispiel wird ein neuer InkAnalyzer erstellt, und an die Strokes-Eigenschaft für den InkCanvas mit dem Namen theInkCanvas wird der StrokesChanged-Ereignishandler angefügt.

theInkAnalyzer = New InkAnalyzer()

AddHandler theInkCanvas.Strokes.StrokesChanged, AddressOf Strokes_StrokesChanged

theInkAnalyzer = new InkAnalyzer();

theInkCanvas.Strokes.StrokesChanged += 
    new StrokeCollectionChangedEventHandler(Strokes_StrokesChanged);

Im folgenden Beispiel wird der Strokes_StrokesChanged-Ereignishandler definiert, der Striche zu theInkAnalyzer hinzufügt, wenn sie bereits zu theInkCanvas. hinzugefügt wurden. Außerdem entfernt der Ereignishandler Striche aus theInkAnalyzer, wenn sie bereits aus theInkCanvas entfernt wurden.

' This event occurs whenever a stroke is added, removed, or partially erased
' from the InkCanvas.
Sub Strokes_StrokesChanged(ByVal sender As Object, ByVal e As StrokeCollectionChangedEventArgs) 
    If e.Added.Count > 0 Then
        theInkAnalyzer.AddStrokes(e.Added)
    End If

    If e.Removed.Count > 0 Then
        theInkAnalyzer.RemoveStrokes(e.Removed)
    End If

End Sub 'Strokes_StrokesChanged

// This event occurs whenever a stroke is added, removed, or partially erased
// from the InkCanvas.
void Strokes_StrokesChanged(object sender, StrokeCollectionChangedEventArgs e)
{
    if (e.Added.Count > 0)
    {
        theInkAnalyzer.AddStrokes(e.Added);
    }

    if (e.Removed.Count > 0)
    {
        theInkAnalyzer.RemoveStrokes(e.Removed);
    }
}

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.