InkAnalyzer.RemoveStrokes-Methode

Artikel
11/26/2008

Entfernt eine Strichauflistung aus dem Freihandanalysemodul.

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

Syntax

'Declaration
Public Sub RemoveStrokes ( _
    strokesToRemove As Strokes _
)
'Usage
Dim instance As InkAnalyzer
Dim strokesToRemove As Strokes

instance.RemoveStrokes(strokesToRemove)

public void RemoveStrokes(
    Strokes strokesToRemove
)

public:
void RemoveStrokes(
    Strokes^ strokesToRemove
)

public void RemoveStrokes(
    Strokes strokesToRemove
)

public function RemoveStrokes(
    strokesToRemove : Strokes
)

Parameter

strokesToRemove
Typ: Microsoft.Ink.Strokes
Die zu entfernende Strichauflistung.

Hinweise

Diese Methode entfernt strokesToRemove aus InkAnalyzer.

Diese Methode entfernt jeden Strich in strokesToRemove aus dem Endkontextknoten, der auf den Strich verweist. Wenn der Kontextknoten auf keine Striche mehr verweist, wird er von dieser Methode zusammen mit allen Vorgängerknoten gelöscht, die über keine untergeordneten Knoten mehr verfügen.

Nachdem diese Methode die Striche aus dem Kontextknoten entfernt hat, aktualisiert sie DirtyRegion, um das umgebende Feld der entfernten Striche einzuschließen.

Diese Methode ignoriert Striche, die nicht dem Freihandanalysemodul zugeordnet sind. Wenn keiner der Striche in strokesToRemove dem Freihandanalysemodul zugeordnet ist, gibt diese Methode einen Wert zurück, ohne dass das Freihandanalysemodul aktualisiert wird.

Diese Methode löst eine System.ArgumentNullException aus, wenn strokesToRemovenullNULL-Verweis (Nothing in Visual Basic) ist.

Beispiele

In diesem Beispiel werden alle dem InkAnalyzer, theInkAnalyzer, zugeordneten Striche aus dem Freihandanalysemodul entfernt, und außerdem aus dem Microsoft.Ink.Ink-Objekt, das theInkAnalyzer zugeordnet ist.

' Get all the strokes associated with the ink analyzer.
Dim theStrokes As Microsoft.Ink.Strokes = Me.theInkAnalyzer.RootNode.Strokes

If Nothing IsNot theStrokes Then
    ' Remove the strokes from the analyzer.
    Me.theInkAnalyzer.RemoveStrokes(theStrokes)

    ' Deleted the strokes from the associated Ink object.
    Me.theInkAnalyzer.Ink.DeleteStrokes(theStrokes)
End If

// Get all the strokes associated with the ink analyzer.
Microsoft.Ink.Strokes theStrokes = this.theInkAnalyzer.RootNode.Strokes;

if (null != theStrokes)
{
    // Remove the strokes from the analyzer.
    this.theInkAnalyzer.RemoveStrokes(theStrokes);

    // Deleted the strokes from the associated Ink object.
    this.theInkAnalyzer.Ink.DeleteStrokes(theStrokes);
}

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.