InkAnalyzer.RemoveStrokes Method

Article
12/12/2007

Removes a strokes collection from the InkAnalyzer.

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

Syntax

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

instance.RemoveStrokes(strokesToRemove)

public void RemoveStrokes (
    StrokeCollection strokesToRemove
)

public:
void RemoveStrokes (
    StrokeCollection^ strokesToRemove
)

public void RemoveStrokes (
    StrokeCollection strokesToRemove
)

public function RemoveStrokes (
    strokesToRemove : StrokeCollection
)

Not applicable.

Parameters

strokesToRemove
The strokes collection to remove.

Remarks

This method removes strokesToRemove from the InkAnalyzer.

This method removes each stroke in strokesToRemove from the leaf context node that references the strokes. If the context node no longer references any strokes, this method deletes the context node and any ancestor nodes that no longer have child nodes.

After this method removes the strokes from the context node, it updates the DirtyRegion to include the bounding box of the removed strokes.

This method ignores strokes that are not associated with the ink analyzer. If none of the strokes in strokesToRemove are associated with the ink analyzer, this method returns without updating the ink analyzer.

This method throws a ArgumentNullException when strokesToRemove is a null reference (Nothing in Visual Basic).

Example

The following example defines the Strokes_StrokesChanged event handler, which adds the strokes that have been added to theInkCanvas to theInkAnalyzer and removes the strokes that have been removed from theInkCanvas from theInkAnalyzer.

Platforms

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0