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

[C#]
public double XYTolerance {get; set;}

[C++]
HRESULT get_XYTolerance(
  double* XYTolerance
);

[C++]
HRESULT put_XYTolerance(
  double XYTolerance
);

[C++]

Parameters
XYTolerance [out, retval]
  XYTolerance is a parameter of type double
XYTolerance 
  XYTolerance is a parameter of type double

Product Availability

Remarks

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