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

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
)

Parameters

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

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

eraserShape
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

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft