ArcObjects Library Reference (GeoDatabase)  

esriSpatialRelEnum Constants

Queryable Spatial Relationships.

Constant Value Description
esriSpatialRelUndefined 0 No Defined Spatial Relationship.
esriSpatialRelIntersects 1 Query Geometry Intersects Target Geometry.
esriSpatialRelEnvelopeIntersects 2 Envelope of Query Geometry Intersects Envelope of Target Geometry.
esriSpatialRelIndexIntersects 3 Query Geometry Intersects Index entry for Target Geometry (Primary Index Filter).
esriSpatialRelTouches 4 Query Geometry Touches Target Geometry.
esriSpatialRelOverlaps 5 Query Geometry Overlaps Target Geometry.
esriSpatialRelCrosses 6 Query Geometry Crosses Target Geometry.
esriSpatialRelWithin 7 Query Geometry is Within Target Geometry.
esriSpatialRelContains 8 Query Geometry Contains Target Geometry.
esriSpatialRelRelation 9 Query geometry IBE(Interior-Boundary-Exterior) relationship with target geometry.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Remarks

esriSpatialRelUndefined

Used when the spatial relationship is not known at the time of object creation.

esriSpatialRelIntersects


Returns a feature if any spatial relationship is found. Applies to all shape type combinations.

esriSpatialRelEnvelopeIntersects

Returns a feature if the envelope of the two shapes intersects.

esriSpatialRelIndexIntersects

Returns a feature if the envelope of the query geometry intersects the index entry for the target geometry.  Because it uses the underlying index grid, rather than the evelope of the feature, it is faster and is commonly used for return features for display purposes.

esriSpatialRelTouches


Returns a feature if the two shapes share a common boundary. However, the intersection of the interiors of the two shapes must be empty. In the Point/Line case, the point may touch an endpoint only of the line. Applies to all combinations except Point/Point.

esriSpatialRelOverlaps

Returns a feature if the intersection of the two shapes results in an object of the same dimension, but different from both of the shapes. Applies to Area/Area, Line/Line, and Multi-point/Multi-point shape type combinations.

esriSpatialRelCrosses

Returns a feature if the intersection of the interiors of the two shapes is not empty and has a lower dimension than the maximum dimension of the two shapes. Two lines that share an endpoint in common do not cross. Valid for Line/Line, Line/Area, Multi-point/Area, and Multi-point/Line shape type combinations.

esriSpatialRelWithin

Returns a feature if its shape wholly contains the search geometry. Valid for all shape type combinations.

esriSpatialRelContains

Returns a feature if its shape is wholly contained within the search geometry. Valid for all shape type combinations.

esriSpatialRelRelation

This is the expected value for ISpatialFilter::SpatialRel when using ISpatialFilter::SpatialRelDescription to define a custom spatial relationship. See the help on ISpatialFilter for details.

See Also

esriSpatialRelEnum Constants | ISpatialFilter Interface

.NET Snippets

Perform Spatial Query |

.NET Samples

Cut polygons without selection edit task (Code Files: CutPolygonsWithoutSelectionEditTask) | Editing using a custom form (Code Files: EditorForm) | Find near features REST SOE (Code Files: FindNearFeaturesRestSOE_VBNet) | Find near features SOAP SOE (Code Files: FindNearFeaturesSoapSOE_VBNet Reference) | Server spatial query COM utility (Code Files: VegUtils_VBNet) | ViperPin tool (Code Files: ViperPinForm) |

.NET Related Topics

Executing spatial queries | GeoData services | Geodatabase | How to create a replica in a connected environment | How to download images from an image service | How to query an image service | Map services | Querying geodatabase tables | SOAP Web services | Updating attributes of existing features | Utility COM objects |