Cut(Multipart,Polyline,Boolean) Method

In This Topic

Splits this geometry into parts.

Syntax

C#
Visual Basic (Declaration)

IReadOnlyList<Geometry> Cut( 
   Multipart multipart,
   Polyline cutter,
   bool considerTouch
)

Overloads Function Cut( _
   ByVal multipart As Multipart, _
   ByVal cutter As Polyline, _
   ByVal considerTouch As Boolean _
) As IReadOnlyList(Of Geometry)

Parameters

multipart: The polygon or polyline to cut.
cutter: The cutting polyline.
considerTouch: Indicates whether to consider a touch event to be a cut. It applies only when the cuttee is a polyline.

Return Value

An IReadOnlyList<Geometry> representing the cut geometries. If the cutter or cuttee is empty, then an empty list is returned. If there are no cuts, then an empty list is returned. If the left cut doesn't exist, then the first geometry will be empty. Similarly, if the right cut doesn't exist, the second geometry will be empty. An undefined cut will be produced only if a left or right cut exists and there is a part leftover.

Exceptions

Exception	Description
System.ArgumentNullException	Either cuttee or cutter or both are null.
System.NotImplementedException	The method is not implemented for GeometryBag.
System.InvalidOperationException	Incompatible spatial references between the input geometries.

Remarks

When a polyline/polygon is cut, it is split where it intersects the cutter polyline. For polylines, all left cuts will be grouped together in the first polyline, right cuts and coincident cuts will be grouped together in the second polyline, and each undefined cut and any uncut parts are output as separate polylines. For polygons, all left cuts are grouped together in the first polygon, all right cuts are grouped together in the second polygon, and each undefined cut and any uncut parts are output as separate polygons. See Cut operation Pro Concepts topic for more information.

GeometryEngine Cut

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3.4 or higher.

Reference

IGeometryEngine Interface
IGeometryEngine Members
Overload List

Send feedback