ArcObjects Library Reference (Geometry)  

ISpatialReferenceResolution.XYResolution Property

The XY resolution (distance in SR units between distinguishable grid points) of this spatial reference. Reported in meters for PCS/UCS and degrees for GCS when bStandardUnits is true or in current units of SR when it is false.

[Visual Basic .NET]
Public Function get_XYResolution ( _
    ByVal bStandardUnits As Boolean _
) As Double
[Visual Basic .NET]
Public Sub set_XYResolution ( _
    ByVal bStandardUnits As Boolean, _
    ByVal XYResolution As Double _
)
[C#]
public double get_XYResolution (
    bool bStandardUnits
);
[C#]
public void set_XYResolution (
    bool bStandardUnits,
    double XYResolution
);
[C++]
HRESULT get_XYResolution(
  VARIANT_BOOL bStandardUnits,
  double* XYResolution
);
[C++]
HRESULT put_XYResolution(
  VARIANT_BOOL bStandardUnits,
  double XYResolution
);
[C++]

Parameters

bStandardUnits   bStandardUnits is a parameter of type VARIANT_BOOL XYResolution [out, retval]   XYResolution is a parameter of type double bStandardUnits   bStandardUnits is a parameter of type VARIANT_BOOL XYResolution   XYResolution is a parameter of type double

Product Availability

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

Remarks

XYResolution determines the distinguishable distance between two points in horizontal (XY) space. It is the inverse of the scale factor.

XYResolution can be expressed in standard units or units defined by the spatial reference.  For ProjectedCoordinateSystems and UnknownCoordinateSystems the standard unit is expressed in meters; for GeographicCoordinateSystems the standard unit is expressed in degrees.

The default XYResolution for ProjectedCoordinateSystems and UnknownCoordinateSystems is either 1 mm (low-precision spatial reference) or 0.1 mm (high-precision spatial reference). For GeographicCoordinateSystems the default XYResolution is 1/500 arc-second (low-precision spatial reference) or 1/10000 arc-second (high-precision spatial reference).  The precision of a spatial reference is determined using IControlPrecision2::IsHighPrecision. At ArcGIS 9.2 all spatial references are created using high precision by default.

Altering this property preserves the current false origin of the spatial reference if it has already been defined. Otherwise, the ConstructFromHorizon method is used to define a false origin.

Use ISpatialReferenceResolution::XYResolution(False) to return or set the XYResolution in the units defined as part of the spatial reference.

The default value for XYResolution is NaN (not-a-number) for a new spatial reference.  If the XYResolution has not been set previously, calls to ISpatialReference::SetDomain or ISpatialReference::SetFalseOriginAndUnits will set the XYResolution to the minimum allowable value (2.0/XYunits).

See Also

ISpatialReferenceResolution Interface