ISpatialReferenceResolution.ZResolution Property

The Z resolution (height/depth distance between distinguishable grid points) of this spatial reference. Reported in meters when bStandardUnits is true or in current units of SR when it is false.

[Visual Basic .NET]
Public Function get_ZResolution ( _
    ByVal bStandardUnits As Boolean _
) As Double

[Visual Basic .NET]
Public Sub set_ZResolution ( _
    ByVal bStandardUnits As Boolean, _
    ByVal ZResolution As Double _
)

[C#]
public double get_ZResolution (
    bool bStandardUnits
);

[C#]
public void set_ZResolution (
    bool bStandardUnits,
    double ZResolution
);

[C++]
HRESULT get_ZResolution(
  VARIANT_BOOL bStandardUnits,
  double ZResolution
);

[C++]
HRESULT put_ZResolution(
  VARIANT_BOOL bStandardUnits,
  System.Double* ZResolution
);

[C++]
Parameters
bStandardUnits 

  bStandardUnits is a parameter of type bool
ZResolution 

  ZResolution is a parameter of type double
bStandardUnits 

  bStandardUnits is a parameter of type bool
ZResolution [out, retval]

  ZResolution is a parameter of type double*

Product Availability

Remarks

ZResolution resizes the existing grid about its center to achieve a target resolution of 1mm for low precision spatial references or 1/10 mm for high precision.  This property provides finer control for specifying the resolution than does ISpatialReferenceResolution::SetDefaultZResolution. The default ZResolution is defined in standard units as 0.1 mm for high and low precision spatial references, or 1 mm for low precision spatial references.  For ProjectedCoordinateSystems and GeographicCoordinateSystems, that default value is scaled to whatever units are associated with the spatial reference's VerticalCoordinateSystem property.

Use ISpatialReferenceResolution::ZResolution(False) to specify or retrieve the Z resolution in units defined by the vertical coordinate system. 

The default value for ZResolution is NaN for a new spatial reference.  If the ZResolution is not well-defined (ZResolution is NaN), calls to ISpatialReference::SetZDomain or ISpatialReference::SetZFalseOriginAndUnits will set the ZResolution to the minimum allowable value (2.0/zUnits).  If the ZResolution was already defined, these methods will not alter the ZResolution.

See Also