StrokeCollection.Replace Method (StrokeCollection, StrokeCollection)

 

Replaces the specified StrokeCollection with a new StrokeCollection.

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

public void Replace(
	StrokeCollection strokesToReplace,
	StrokeCollection strokesToReplaceWith
)

Parameters

strokesToReplace
Type: System.Windows.Ink.StrokeCollection

The destination StrokeCollection.

strokesToReplaceWith
Type: System.Windows.Ink.StrokeCollection

The source StrokeCollection.

Exception Condition
ArgumentException

strokesToReplace is empty.

-or-

strokesToReplaceWith is empty.

-or-

A Stroke in strokesToReplaceWith is already in strokesToReplace.

-or-

The strokes in strokesToReplaceWith are not continuous.

The Replace method raises the StrokesChanged event for each Stroke it replaces.

The following example demonstrates how to replace the selected strokes on an InkCanvas with another StrokeCollection. This example assumes that there is an InkCanvas called inkCanvas1.

// Replace the selected strokes with other strokes.
private void ReplaceStrokes(StrokeCollection strokes)
{
    StrokeCollection selectedStrokes = inkCanvas1.GetSelectedStrokes();

    if (selectedStrokes != null && selectedStrokes.Count > 0)
    {
        inkCanvas1.Strokes.Replace(selectedStrokes, strokes);
    }
}

.NET Framework
Available since 3.0
Return to top
Show: