ITopologicalOperator.Cut Method

Splits this geometry into a part left of the cutting polyline, and a part right of it.

[Visual Basic .NET]
Public Sub Cut ( _
    ByVal cutter As IPolyline, _
    ByRef leftGeom As IGeometry, _
    ByRef rightGeom As IGeometry _
)

[C#]
public void Cut (
    IPolyline cutter,
    ref IGeometry leftGeom,
    ref IGeometry rightGeom
);

[C++]
HRESULT Cut(
  IPolyline* cutter,
  IGeometry** leftGeom,
  IGeometry** rightGeom
);

[C++]
Parameters
cutter 

  cutter is a parameter of type IPolyline*
leftGeom [out]

  leftGeom is a parameter of type IGeometry**
rightGeom [out]

  rightGeom is a parameter of type IGeometry**

Product Availability

Remarks

ITopologicalOperator methods must be applied on high-level geometries only. High-Level geometries are point, multipoint, polyline and polygon. To use this method with low-level geometries such as segments (Line, Circular Arc, Elliptic Arc, Bézier Curve), paths or rings, they must be wrapped into high-level geometries types.

When a polyline/polygon is cut, it is split where it intersects the cutter polyline. Each piece is classified as ‘left of’ or ‘right of’ the cutter. This classification is based on the orientation of the cutter line. Parts of the target polyline that do not intersect the cutting polyline are returned as part of the ‘right of’ result for that input polyline.  If a geometry is not cut, the left geometry will be empty.

When using a multi-part polyline to cut a single ring of a polyline, the orientation of the polyline paths is important. The cut piece of the ring must be on the same side of each cutting path as defined by the orientation of each path.

This method does not support GeometryBags.

See Also