com.esri.arcgis.geodatabase
Interface IGeoDatasetSchemaEdit2

All Superinterfaces:

IGeoDatasetSchemaEdit, Serializable

All Known Implementing Classes:

IGeoDatasetSchemaEdit2Proxy

public interface IGeoDatasetSchemaEdit2
extends IGeoDatasetSchemaEdit, Serializable

Provides access to members that change the geodata transformation of a GeoDataset.

Remarks

The IGeoDatasetSchemaEdit2 interface is an optional interface that allows you to change the transformation associated with an existing dataset.

Product Availability

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

Method Summary

void	alterGeodataXform(IGeodataXform xform) Alters the geodata transformation of the dataset (does not transform the data).
void	alterResolution(double xyResolution, double zResolution, double mResolution) Alters the resolution of the dataset and rebuilds the spatial indexes.
void	constructResolutions(ISpatialReference spatialReference, int numberRequested, int[] defaultXYResolutionIndex, IDoubleArray[] xyResolutions, IDoubleArray[] zResolutions, IDoubleArray[] mResolutions) Returns a list of possible resolutions (precisions) and the doubling factors that produce them from the specified low precision spatial reference.
boolean	isCanAlterGeodataXform() Indicates if the geodata transformation of the dataset can be altered.

Methods inherited from interface com.esri.arcgis.geodatabase.IGeoDatasetSchemaEdit

alterSpatialReference, isCanAlterSpatialReference

Method Detail

isCanAlterGeodataXform

boolean isCanAlterGeodataXform()
                               throws IOException,
                                      AutomationException

Indicates if the geodata transformation of the dataset can be altered.

Product Availability

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

Returns:

The canAlter

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

alterGeodataXform

void alterGeodataXform(IGeodataXform xform)
                       throws IOException,
                              AutomationException

Alters the geodata transformation of the dataset (does not transform the data).

Product Availability

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

Parameters:

xform - A reference to a com.esri.arcgis.geodatabase.IGeodataXform (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

alterResolution

void alterResolution(double xyResolution,
                     double zResolution,
                     double mResolution)
                     throws IOException,
                            AutomationException

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

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.

Product Availability

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

Parameters:

xyResolution - The xyResolution (in)

zResolution - The zResolution (in)

mResolution - The mResolution (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

constructResolutions

void constructResolutions(ISpatialReference spatialReference,
                          int numberRequested,
                          int[] defaultXYResolutionIndex,
                          IDoubleArray[] xyResolutions,
                          IDoubleArray[] zResolutions,
                          IDoubleArray[] mResolutions)
                          throws IOException,
                                 AutomationException

Returns a list of possible resolutions (precisions) and the doubling factors that produce them from the specified low precision spatial reference. The zeroth returned element is the current precision of the spatial reference.

Remarks

ConstructResolutions should be used to determine the acceptable levels of resolution available for AlterResolution.

Product Availability

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

Parameters:

spatialReference - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)

numberRequested - The numberRequested (in)

defaultXYResolutionIndex - The defaultXYResolutionIndex (out: use single element array)

xyResolutions - A reference to a com.esri.arcgis.system.IDoubleArray (out: use single element array)

zResolutions - A reference to a com.esri.arcgis.system.IDoubleArray (out: use single element array)

mResolutions - A reference to a com.esri.arcgis.system.IDoubleArray (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.