Interface ITopologicalOperator3
Provides additional information on non-simple geometries.
[Guid("D4DC3B12-88EA-42D8-87B7-4EB7460737C1")]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
public interface ITopologicalOperator3 : ITopologicalOperator2, ITopologicalOperator
Remarks
ITopologicalOperator3 methods must be applied on high-level geometries only. High-Level geometries are point, multipoint, polyline and polygon. To use this interface with low-level geometries such as segments (Line, Circular Arc, Elliptic Arc, Bezier Curve), paths or rings, they must be wrapped into high-level geometry types.
Properties
Boundary
IGeometry Boundary { get; }
Property Value
IsKnownSimple
bool IsKnownSimple { get; }
Property Value
IsKnownSimple_2
bool IsKnownSimple_2 { set; }
Property Value
IsSimple
bool IsSimple { get; }
Property Value
IsSimpleEx[esriNonSimpleReasonEnum]
Determines why a geometry is not simple. Currently only implemented for polygons.
bool IsSimpleEx[out esriNonSimpleReasonEnum reason] { get; }
Parameters
reasonesriNonSimpleReasonEnum
Property Value
Remarks
Note: All geometries involved in ITopologicalOperator operations must be high-level geometries. High-Level geometries are point, multipoint, polyline and polygon. To use it with low-level geometries such as segments (Line, Circular Arc, Elliptic Arc, Bézier Curve), path or ring they must be wrapped into high-level geometries type.
The xy cluster tolerance value of the geometry's associated
spatial reference is used by this method. If the goal of this
method is to determine if a geometry can be persisted in an sde (or
other integer-based) layer without alteration, you may wish to use
the minimum xy cluster tolerance value
(ISpatialReferenceTolerance::SetMinimumXYTolerance) before applying
this method (don't forget to set it back).
//How to use get_IsSimpleEx
ITopologicalOperator3 topoOp3 = inGeom as ITopologicalOperator3; //Must be polygon
ESRI.ArcGIS.Geometry.esriNonSimpleReasonEnum reason = ESRI.ArcGIS.Geometry.esriNonSimpleReasonEnum.esriNonSimpleOK; //Initialize
topoOp3.IsKnownSimple_2 = false;
Boolean pBool = topoOp3.get_IsSimpleEx(out reason); //Inspect pReason for description code
//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
Methods
Buffer(double)
IGeometry Buffer(double distance)
Parameters
distancedouble
Returns
Clip(IEnvelope)
void Clip(IEnvelope clipperEnvelope)
Parameters
clipperEnvelopeIEnvelope
ClipDense(IEnvelope, double)
void ClipDense(IEnvelope clipperEnvelope, double denseDistance)
Parameters
ClipToDomain()
void ClipToDomain()
ConstructBuffers(int, ref double)
IEnumGeometry ConstructBuffers(int numBuffers, ref double distances)
Parameters
Returns
ConstructUnion(IEnumGeometry)
void ConstructUnion(IEnumGeometry geometries)
Parameters
geometriesIEnumGeometry
ConvexHull()
IGeometry ConvexHull()
Returns
Cut(IPolyline, out IGeometry, out IGeometry)
void Cut(IPolyline cutter, out IGeometry leftGeom, out IGeometry rightGeom)
Parameters
Difference(IGeometry)
IGeometry Difference(IGeometry other)
Parameters
otherIGeometry
Returns
GeoNormalizeEx(ISpatialReference, double)
Shifts longitudes, if need be, into a continuous range of 360 degrees.
void GeoNormalizeEx(ISpatialReference SR, double denseDistance)
Parameters
SRISpatialReferencedenseDistancedouble
Remarks
Not implemented for Multipatches.
Intersect(IGeometry, esriGeometryDimension)
IGeometry Intersect(IGeometry other, esriGeometryDimension resultDimension)
Parameters
otherIGeometryresultDimensionesriGeometryDimension
Returns
IntersectMultidimension(IGeometry)
IGeometry IntersectMultidimension(IGeometry other)
Parameters
otherIGeometry
Returns
QueryClipped(IEnvelope, IGeometry)
void QueryClipped(IEnvelope clipperEnvelope, IGeometry clippedGeometry)
Parameters
QueryClippedDense(IEnvelope, double, IGeometry)
void QueryClippedDense(IEnvelope clipperEnvelope, double denseDistance, IGeometry clippedGeometry)
Parameters
Simplify()
void Simplify()
SymmetricDifference(IGeometry)
IGeometry SymmetricDifference(IGeometry other)
Parameters
otherIGeometry
Returns
TopologyCache(out long)
void TopologyCache(out long topologyCacheHandle)
Parameters
topologyCacheHandlelong
Union(IGeometry)
IGeometry Union(IGeometry other)
Parameters
otherIGeometry