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,
  double ZResolution
);

[C++]

Parameters
bStandardUnits 
  bStandardUnits is a parameter of type VARIANT_BOOL
ZResolution [out, retval]
  ZResolution is a parameter of type double
bStandardUnits 
  bStandardUnits is a parameter of type VARIANT_BOOL
ZResolution 
  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