IGeoDatasetSchemaEdit2.AlterResolution Method

Alters the resolution of the dataset and rebuilds the spatial indexes.

[Visual Basic .NET]
Public Sub AlterResolution ( _
    ByVal xyResolution As Double, _
    ByVal zResolution As Double, _
    ByVal mResolution As Double _
)

[C#]
public void AlterResolution (
    double xyResolution,
    double zResolution,
    double mResolution
);

[C++]
HRESULT AlterResolution(
  double xyResolution,
  double zResolution,
  double mResolution
);

[C++]
Parameters
xyResolution [in]

  xyResolution is a parameter of type double
zResolution [in]

  zResolution is a parameter of type double
mResolution [in]

  mResolution is a parameter of type double

Product Availability

Remarks

AlterResolution will change the resolution of the dataset based on the supplied XY, Z and M resolution values and rebuild the spatial indices.  AlterResolution can only be used on Low Precision datasets within a 9.2 Geodatabase.  To determine if AlterPrecision can be used on dataset, use the IControlPrecision2::IsHighPrecision  property.

Use the IGeoDatasetSchemaEdit2::ConstructResolutions method to obtain the applicable levels of resolution for your data.

If a value of -1 is supplied for the xyResolution or zResolution arguments, the current resolution will be maintained.  The current resolution of for a dataset can be obtained from its spatial reference using the ISpatialReferenceResolution interface.

Any of the following scenarios will result in an error:

• If a value supplied is not equal to one of the possible resolutions returned by IGeoDatasetSchemaEdit2::ConstructResolutions.
• If a resolution value that is coarser or larger than the current resolution is supplied.
• If a value of 0 or a negative value other than -1 is supplied.

See Also