StrokeCollection.Erase Method (IEnumerable<Point>, StylusShape)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Replaces all strokes that are clipped by the region created by the specified StylusShape along the specified path with new Strokes that are not clipped by the region.

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

public void Erase(
	IEnumerable<Point> eraserPath,
	StylusShape eraserShape


Type: System.Collections.Generic.IEnumerable<Point>

An array of type Point that specifies the path to be erased.

Type: System.Windows.Ink.StylusShape

A StylusShape that specifies the shape of the eraser.

The StrokeCollection might contain new strokes after the Erase method is called. For example, if path intersects the middle of a Stroke, the erase method removes that Stroke and creates two new strokes.

The Erase method raises the StrokesChanged event for each Stroke it erases.

The following example demonstrates how to erase ink along a specific path. This example assumes that there is an InkPresenter called presenter.

// Erase the ink that intersects the lasso.
public void ErasePath(Stroke lasso)
    EllipseStylusShape eraserTip = new EllipseStylusShape(5, 5);
    Point[] strokePoints = (Point[])lasso.StylusPoints;

    presenter.Strokes.Erase(strokePoints, eraserTip);

.NET Framework
Available since 3.0
Return to top