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:

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.