This document is archived and information here might be outdated.  Recommended version.

ISpatialReferenceTolerance.XYTolerance Property (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Geometry > ESRI.ArcGIS.Geometry > Interfaces > IS > ISpatialReferenceTolerance Interface > ISpatialReferenceTolerance.XYTolerance Property
ArcGIS Developer Help

ISpatialReferenceTolerance.XYTolerance Property

The xy tolerance used to control point coalescing in the X and Y dimensions.

[Visual Basic .NET]
Public Property XYTolerance As Double
public double XYTolerance {get; set;}
HRESULT get_XYTolerance(
  System.Double* XYTolerance
HRESULT put_XYTolerance(
  double XYTolerance
XYTolerance [out, retval]

XYTolerance is a parameter of type double* XYTolerance
XYTolerance is a parameter of type double

Product Availability

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


The XYTolerance property is the planar cluster tolerance associated with a spatial reference that will be used by geometric and relational operators. It has the same meaning as the cluster tolerance parameter presented in other parts of ArcGIS, including topology and Geoprocessing. The default value is 1mm (scaled to whatever units are associated with the spatial reference) for ProjectedCoordinateSystems and UnknownCoordinateSystems, and the angle corresponding to 1mm along the equator for geographic coordinate systems.

Setting the XYTolerance using this property provides finer control than SetDefaultXYTolerance or SetMinimumXYTolerance.    

The minimum allowable XYTolerance is 2.0 * XYResolution. XYTolerance is undefined (NaN) by after creating a spatial reference.  Operations on the spatial reference that define its coordinate grid will set the tolerance to its minimum value if its currently NaN. The tolerance is not modified if the grid resolution changes. To ensure that the XYTolerance specified is valid, use XYToleranceValid.

See Also

ISpatialReferenceTolerance Interface