Splits this geometry into a part left of the cutting polyline, and a part right of it.
[Visual Basic 6.0] Sub Cut(
ByVal cutter As IPolyline, _
leftGeom As IGeometry, _
rightGeom As IGeometry _
)
[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 );
[Java] public void cut ( IPolyline cutter, IGeometry leftGeom, IGeometry rightGeom ) throws IOException, AutomationException
[C++] HRESULT Cut( IPolyline* cutter, IGeometry** leftGeom, IGeometry** rightGeom );
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
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.
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.
This method does not support GeometryBags.
//The following code shows to wrap a line segment into a polyline in C#
//Assume a line (line1 as ILine) is already created
object obj = Type.Missing;
ISegmentCollection segCollection = new PolylineClass() as ISegmentCollection;
segCollection.AddSegment((ISegment)line1, ref obj, ref obj);
//Set the spatial reference on the new polyline
//The spatial reference is not transfered automatically from the segments
IGeometry geom = segCollection as IGeometry;
geom.SpatialReference = spatialRef;
//Can now be used with ITopologicalOperator methods
'How to wrap a line segment into a polyline in VB6
'Assume a line (pLine as ILine) is already created
dim psc as ISegmentCollection
set psc = New Polyline
psc.addsegment pline
'Set the spatial reference on the new polyline
'The spatial reference is not transfered automatically from the segments
dim pgeo as IGeometry
set pgeo = psc
set pgeo.SpatialReference = pMyspatialReference
'Can now be used with ITopologicalOperator methods
See Also
ITopologicalOperator Interface