ITopologicalOperator Interface

Provides access to members for constructing new geometries based upon topological relationships between existing geometries. Note: the ITopologicalOperator interface has been superseded byITopologicalOperator5. Please consider using the more recent version.

Product Availability

Members

	All Properties Methods	Description
	Boundary	The boundary of this geometry. A polygon's boundary is a polyline. A polyline's boundary is a multipoint. A point or multipoint's boundary is an empty point or multipoint.
	Buffer	Constructs a polygon that is the locus of points at a distance less than or equal to a specified distance from this geometry.
	Clip	Constructs the intersection of this geometry and the specified envelope.
	ClipDense	Constructs the intersection of this geometry and the specified envelope; densifies lines in output contributed by the clipping envelope.
	ConstructUnion	Defines this geometry to be the union of the inputs. More efficient for unioning multiple geometries than calling Union repeatedly.
	ConvexHull	Constructs the convex hull of this geometry.
	Cut	Splits this geometry into a part left of the cutting polyline, and a part right of it.
	Difference	Constructs the geometry containing points from this geometry but not the other geometry.
	Intersect	Constructs the geometry that is the set-theoretic intersection of the input geometries. Use different resultDimension values to generate results of different dimensions.
	IsKnownSimple	Indicates whether this geometry is known (or assumed) to be topologically correct.
	IsSimple	Indicates whether this geometry is known (or assumed) to be topologically correct, after explicitly determining this if the geometry is not already known (or assumed) to be simple.
	QueryClipped	Redefines clippedGeometry to be the intersection of this geometry and the clipping envelope.
	QueryClippedDense	Redefines clippedGeometry to be the intersection of this geometry and the clipping envelope; densifies lines in the output contributed by the clipping envelope.
	Simplify	Makes this geometry topologically correct.
	SymmetricDifference	Constructs the geometry that contains points from either but not both input geometries.
	Union	Constructs the geometry that is the set-theoretic union of the input geometries.

CoClasses that implement ITopologicalOperator

Remarks

Buffer, Clip, and Simplify are the only methods of ITopologicalOperator supported on GeometryBags.

ITopologicalOperator 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.

For multipatch geometries, generally the footprint or envelope is used.

Every Geometry created within ArcGIS should be assigned a spatial reference. Always attach well-defined spatial references to new geometries. This improves processing efficiency, in particular, when using ITopologicalOperator on geometries that contain curved segments (circular arcs, bezier curves, elliptical arcs). New geometries include any geometry that is created in memory. It does not matter whether it will be stored in a feature class or not. Well-defined as applied to a spatial reference means that it not only has its coordinate system (projection) defined, but also its coordinate grid. The coordinate grid consists of the xy domain, xy resolution, and xy cluster tolerance properties of a spatial reference. If the Geometry includes z or m values, the z or m domains, z or m resolutions, and z or m cluster tolerance properties must also be defined. The cluster tolerance and resolutions can be quickly and easily set using SetDefault methods on ISpatialReferenceResolution and ISpatialReferenceTolerance interfaces.

//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 ITopologicalOperator3 methods

See Also

IGeometry Interface | IRelationalOperator Interface

.NET Snippets

.NET Samples

.NET Related Topics