Geometry.StrokeContains Method

Definition

Determines whether the geometry's stroke contains the specified Point.

Overloads

StrokeContains(Pen, Point)

Determines whether the specified Point is contained in the stroke produced by applying the specified Pen to the geometry.

StrokeContains(Pen, Point, Double, ToleranceType)

Determines whether the specified Point is contained in the stroke produced by applying the specified Pen to the geometry, given the specified margin of error.

StrokeContains(Pen, Point)

Determines whether the specified Point is contained in the stroke produced by applying the specified Pen to the geometry.

C#
public bool StrokeContains(System.Windows.Media.Pen pen, System.Windows.Point hitPoint);

Parameters

pen
Pen

An object that determines the area of the geometry's stroke.

hitPoint
Point

The point to test for containment.

Returns

true if hitPoint is contained in the stroke produced by applying the specified Pen to the geometry; otherwise, false.

Remarks

The default tolerance factor (specified by the StandardFlatteningTolerance property) is used when determining whether the specified point is located in the geometry's stroke. To specify your own tolerance factor, use the StrokeContains overload.

Some Geometry methods (such as StrokeContains) produce or use a polygonal approximation of the geometry. The tolerance factor specifies the maximum distance between points in this polygonal approximation. Smaller tolerance values produce better approximations, but require more processing than an approximation with a large tolerance factor.

Applies to

.NET Framework 4.8.1 and other versions
Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

StrokeContains(Pen, Point, Double, ToleranceType)

Determines whether the specified Point is contained in the stroke produced by applying the specified Pen to the geometry, given the specified margin of error.

C#
public bool StrokeContains(System.Windows.Media.Pen pen, System.Windows.Point hitPoint, double tolerance, System.Windows.Media.ToleranceType type);

Parameters

pen
Pen

An object that defines the stroke of a geometry.

hitPoint
Point

The point to test for containment.

tolerance
Double

The maximum bounds on the distance between points in the polygonal approximation of the geometry. Smaller values produce more accurate results but cause slower execution. If tolerance is less than .000001, .000001 is used instead.

type
ToleranceType

One of the ToleranceType values that specifies whether the tolerance factor is an absolute value or relative to the area of the geometry.

Returns

true if the stroke created by applying the specified Pen to the geometry contains the specified point, given the specified tolerance factor; otherwise, false.

Remarks

Some Geometry methods (such as StrokeContains) produce or use a polygonal approximation of the geometry. The tolerance factor specifies the maximum distance between points in this polygonal approximation. Smaller tolerance values produce better approximations, but require more processing than an approximation with a large tolerance factor.

Applies to

.NET Framework 4.8.1 and other versions
Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9