com.esri.arcgis.geoprocessing
Class IGpDispatchProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.geoprocessing.IGpDispatchProxy

All Implemented Interfaces:

IGpDispatch, Externalizable, Serializable

public class IGpDispatchProxy
extends com.esri.arcgis.interop.Dispatch
implements IGpDispatch, Serializable

Provides access to the properties and methods of a Geoprocessor object.

When To Use

The GPDispatch object is a coarse grainded ArcObject that permits geoprocessing tools and environments to be used in a scripting language. This object supports the COM IDispatch object. This object may also be used in COM-compliant languages such as Visual Basic for Applications (VBA), and Visual Basic. With ArcGIS 9.2, you are now recommended to use the new Geoprocessor class.

Product Availability

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

See Also:

Serialized Form

Field Summary

boolean

noncastable

Fields inherited from class com.esri.arcgis.interop.Dispatch

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef

Constructor Summary

	IGpDispatchProxy()
	IGpDispatchProxy(Object obj)
protected	IGpDispatchProxy(Object obj, String iid)

Method Summary

void	addError(String message) Sets the output error message.
void	addListener(String iidStr, Object theListener, Object theSource)
void	addMessage(String message) Sets the output message.
void	addReturnMessage(int index) Sets the return message as an output message by index.
void	addToolbox(String toolbox) Add the toolbox to the current session.
void	addWarning(String message) Sets the output warning message.
String	checkExtension(String extension) Checks the status of a product extension.
String	checkInExtension(String extension) Checks in a product extension.
String	checkOutExtension(String extension) Checks out a product extension.
String	checkProduct(String code) Check the status of a license code.
void	clearEnvironment(String env) Clears the value of a given environment.
String	command(String commandLine) executes the given command line.
void	copyParameter(int from, int to) Copy given tool parameter to another.
Object	createObject(Object pObjectName, Object pExtraArg) Creates a geoprocessing object that can be used in a scripting environment.
Object	createRandomValueGenerator(int seed, String distributionType) Creates a geoprocessing random number generator object that can be used to generate random numbers.
String	createScratchName(Object prefix, Object suffix, Object dataType, Object workspace) Creates a scratch name for the given workspace.
String	createUniqueName(String inputTableName, Object workspace) Creates a unique name for the given workspace.
Object	describe(Object pInputValue, Object dataType) Returns a descriptor object describing the properties of the specified data element.
boolean	exists(Object pInputValue, Object dataType) Checks if a data element exists.
int	getMaxSeverity() The maximum severity of the return messages.
String	getMessage(int index) Gets the return message by index.
int	getMessageCount() The number of returned messages.
String	getMessages(Object severity) Gets all the return messages.
String	getParameterAsText(int index) Gets given tool parameter as text.
int	getParameterCount() The number of input tool parameters.
int	getReturnCode(int index) Gets the return code by index.
int	getSeverity(int index) Gets the return severity by index.
String	getSystemEnvironment(String envName) Gets the given system environment.
String	getToolbox() Sets the current (default) toolbox.
Object	insertCursor(Object pInputValue, Object spRef) Returns an insert cursor object against the given table/feature class.
boolean	isLogHistory() Indicates whether or not operations are logged or not.
boolean	isOverwriteOutput() Indicates whether or not outputs should be overwritten.
Object	listDatasets(Object wildCard, Object featureType) Returns a collection of datasets in the current workspace based on a query string and type.
Object	listEnvironments(Object pWildcard) Gets list of GeoProcessor Environments.
Object	listFeatureClasses(Object wildCard, Object featureType, Object dataset) Returns a collection of feature classes in the current workspace or optional dataset, based on a query string and type.
Object	listFields(Object pInputValue, Object wildCard, Object fieldType) Returns a collection of fields in the given table/feature class based on a query string and type.
Object	listIndexes(Object pInputValue, Object wildCard) Returns a collection of indexes in the given table/feature class based on a query string and type.
Object	listRasters(Object wildCard, Object rasterType) Returns a collection of rasters in the current workspace based on a query string and type.
Object	listTables(Object wildCard, Object tableType) Returns a collection of tables in the current workspace based on a query string and type.
Object	listToolboxes(Object pWildcard) Gets list of GeoProcessor Toolboxes.
Object	listTools(Object pWildcard) Gets list of GeoProcessor Tools.
Object	listWorkspaces(Object wildCard, Object workspaceType) Returns a collection of workspaces in the current workspace based on a query string and type.
void	loadSettings(String fileName) Loads the current GeoProcessor environment settings.
String	parseFieldName(String inputFieldName, Object workspace) Parses a field name into its constituent parts.
String	parseTableName(String inputTableName, Object workspace) Parses a table name into its constituent parts.
String	productInfo() Gets the product license info.
String	qualifyFieldName(String inputFieldName, Object workspace) Qualifies a field name for the workspace and connected user.
String	qualifyTableName(String inputTableName, Object workspace) Qualifies a table name for the workspace and connected user.
void	refreshCatalog(Object pInputValue) Refreshes the parent of the specified object in the catalog object associated with the Geoprocessor.
void	removeListener(String iidStr, Object theListener)
void	removeToolbox(String toolbox) Remove the toolbox from the current session.
void	resetEnvironments() Tests if a given environments value is set or not.
void	saveSettings(String fileName) Saves the current GeoProcessor environment settings.
Object	searchCursor(Object pInputValue, Object whereClause, Object spRef, Object fields, Object sortFields) Returns a search cursor object against the given table/feature class.
void	setLogHistory(boolean logHistory) Indicates whether or not operations are logged or not.
void	setOverwriteOutput(boolean overwriteOutput) Indicates whether or not outputs should be overwritten.
void	setParameterAsText(int index, String argument) Sets given tool parameter as text.
String	setProduct(String code) Sets the license level.
void	setToolbox(String toolbox) Sets the current (default) toolbox.
String	testSchemaLock(String fileName) Tests if an exclusive schema lock is set on a dataset.
Object	updateCursor(Object pInputValue, Object whereClause, Object spRef, Object fields, Object sortFields) Returns an update cursor object against the given table/feature class.
String	usage(String method) Generates the Usage for a given tool.
String	validateFieldName(String inputFieldName, Object workspace) Checks a field for compatibility with the workspace.
String	validateTableName(String inputTableName, Object workspace) Checks a table name for compatibility with the workspace.

Methods inherited from class com.esri.arcgis.interop.Dispatch

bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IGpDispatchProxy

public IGpDispatchProxy()

IGpDispatchProxy

public IGpDispatchProxy(Object obj)
                 throws IOException

Throws:

IOException

IGpDispatchProxy

protected IGpDispatchProxy(Object obj,
                           String iid)
                    throws IOException

Throws:

IOException

Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException

Overrides:

addListener in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException

Overrides:

removeListener in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

getMessageCount

public int getMessageCount()
                    throws IOException,
                           AutomationException

The number of returned messages.

Product Availability

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

Supported Platforms

Windows

Specified by:

getMessageCount in interface IGpDispatch

Returns:

The count

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMessage

public String getMessage(int index)
                  throws IOException,
                         AutomationException

Gets the return message by index.

Product Availability

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

Supported Platforms

Windows

Specified by:

getMessage in interface IGpDispatch

Parameters:

index - The index (in)

Returns:

The message

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSeverity

public int getSeverity(int index)
                throws IOException,
                       AutomationException

Gets the return severity by index.

Product Availability

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

Supported Platforms

Windows

Specified by:

getSeverity in interface IGpDispatch

Parameters:

index - The index (in)

Returns:

The severity

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getReturnCode

public int getReturnCode(int index)
                  throws IOException,
                         AutomationException

Gets the return code by index.

Product Availability

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

Supported Platforms

Windows

Specified by:

getReturnCode in interface IGpDispatch

Parameters:

index - The index (in)

Returns:

The code

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMessages

public String getMessages(Object severity)
                   throws IOException,
                          AutomationException

Gets all the return messages.

Product Availability

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

Supported Platforms

Windows

Specified by:

getMessages in interface IGpDispatch

Parameters:

severity - A Variant (in, optional, pass null if not required)

Returns:

The messages

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMaxSeverity

public int getMaxSeverity()
                   throws IOException,
                          AutomationException

The maximum severity of the return messages.

Product Availability

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

Supported Platforms

Windows

Specified by:

getMaxSeverity in interface IGpDispatch

Returns:

The severity

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addMessage

public void addMessage(String message)
                throws IOException,
                       AutomationException

Sets the output message.

Product Availability

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

Supported Platforms

Windows

Specified by:

addMessage in interface IGpDispatch

Parameters:

message - The message (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addError

public void addError(String message)
              throws IOException,
                     AutomationException

Sets the output error message.

Product Availability

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

Supported Platforms

Windows

Specified by:

addError in interface IGpDispatch

Parameters:

message - The message (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addWarning

public void addWarning(String message)
                throws IOException,
                       AutomationException

Sets the output warning message.

Product Availability

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

Supported Platforms

Windows

Specified by:

addWarning in interface IGpDispatch

Parameters:

message - The message (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addReturnMessage

public void addReturnMessage(int index)
                      throws IOException,
                             AutomationException

Sets the return message as an output message by index.

Product Availability

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

Supported Platforms

Windows

Specified by:

addReturnMessage in interface IGpDispatch

Parameters:

index - The index (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setProduct

public String setProduct(String code)
                  throws IOException,
                         AutomationException

Sets the license level.

Product Availability

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

Supported Platforms

Windows

Specified by:

setProduct in interface IGpDispatch

Parameters:

code - The code (in)

Returns:

The status

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

checkProduct

public String checkProduct(String code)
                    throws IOException,
                           AutomationException

Check the status of a license code.

Product Availability

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

Supported Platforms

Windows

Specified by:

checkProduct in interface IGpDispatch

Parameters:

code - The code (in)

Returns:

The status

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

productInfo

public String productInfo()
                   throws IOException,
                          AutomationException

Gets the product license info.

Product Availability

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

Supported Platforms

Windows

Specified by:

productInfo in interface IGpDispatch

Returns:

The status

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

checkOutExtension

public String checkOutExtension(String extension)
                         throws IOException,
                                AutomationException

Checks out a product extension.

Product Availability

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

Supported Platforms

Windows

Specified by:

checkOutExtension in interface IGpDispatch

Parameters:

extension - The extension (in)

Returns:

The status

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

checkInExtension

public String checkInExtension(String extension)
                        throws IOException,
                               AutomationException

Checks in a product extension.

Product Availability

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

Supported Platforms

Windows

Specified by:

checkInExtension in interface IGpDispatch

Parameters:

extension - The extension (in)

Returns:

The status

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

checkExtension

public String checkExtension(String extension)
                      throws IOException,
                             AutomationException

Checks the status of a product extension.

Product Availability

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

Supported Platforms

Windows

Specified by:

checkExtension in interface IGpDispatch

Parameters:

extension - The extension (in)

Returns:

The status

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getParameterCount

public int getParameterCount()
                      throws IOException,
                             AutomationException

The number of input tool parameters.

Product Availability

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

Supported Platforms

Windows

Specified by:

getParameterCount in interface IGpDispatch

Returns:

The count

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getParameterAsText

public String getParameterAsText(int index)
                          throws IOException,
                                 AutomationException

Gets given tool parameter as text.

Product Availability

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

Supported Platforms

Windows

Specified by:

getParameterAsText in interface IGpDispatch

Parameters:

index - The index (in)

Returns:

The argument

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setParameterAsText

public void setParameterAsText(int index,
                               String argument)
                        throws IOException,
                               AutomationException

Sets given tool parameter as text.

Product Availability

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

Supported Platforms

Windows

Specified by:

setParameterAsText in interface IGpDispatch

Parameters:

index - The index (in)

argument - The argument (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

copyParameter

public void copyParameter(int from,
                          int to)
                   throws IOException,
                          AutomationException

Copy given tool parameter to another.

Product Availability

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

Supported Platforms

Windows

Specified by:

copyParameter in interface IGpDispatch

Parameters:

from - The from (in)

to - The to (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

listTools

public Object listTools(Object pWildcard)
                 throws IOException,
                        AutomationException

Gets list of GeoProcessor Tools.

Product Availability

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

Supported Platforms

Windows

Specified by:

listTools in interface IGpDispatch

Parameters:

pWildcard - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

listEnvironments

public Object listEnvironments(Object pWildcard)
                        throws IOException,
                               AutomationException

Gets list of GeoProcessor Environments.

Product Availability

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

Supported Platforms

Windows

Specified by:

listEnvironments in interface IGpDispatch

Parameters:

pWildcard - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

listToolboxes

public Object listToolboxes(Object pWildcard)
                     throws IOException,
                            AutomationException

Gets list of GeoProcessor Toolboxes.

Product Availability

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

Supported Platforms

Windows

Specified by:

listToolboxes in interface IGpDispatch

Parameters:

pWildcard - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setToolbox

public void setToolbox(String toolbox)
                throws IOException,
                       AutomationException

Sets the current (default) toolbox.

Product Availability

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

Supported Platforms

Windows

Specified by:

setToolbox in interface IGpDispatch

Parameters:

toolbox - The toolbox (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getToolbox

public String getToolbox()
                  throws IOException,
                         AutomationException

Sets the current (default) toolbox.

Product Availability

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

Supported Platforms

Windows

Specified by:

getToolbox in interface IGpDispatch

Returns:

The toolbox

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addToolbox

public void addToolbox(String toolbox)
                throws IOException,
                       AutomationException

Add the toolbox to the current session.

Product Availability

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

Supported Platforms

Windows

Specified by:

addToolbox in interface IGpDispatch

Parameters:

toolbox - The toolbox (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

removeToolbox

public void removeToolbox(String toolbox)
                   throws IOException,
                          AutomationException

Remove the toolbox from the current session.

Product Availability

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

Supported Platforms

Windows

Specified by:

removeToolbox in interface IGpDispatch

Parameters:

toolbox - The toolbox (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSystemEnvironment

public String getSystemEnvironment(String envName)
                            throws IOException,
                                   AutomationException

Gets the given system environment.

Product Availability

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

Supported Platforms

Windows

Specified by:

getSystemEnvironment in interface IGpDispatch

Parameters:

envName - The envName (in)

Returns:

The pEnvironment

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

command

public String command(String commandLine)
               throws IOException,
                      AutomationException

executes the given command line.

Product Availability

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

Supported Platforms

Windows

Specified by:

command in interface IGpDispatch

Parameters:

commandLine - The commandLine (in)

Returns:

The results

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

usage

public String usage(String method)
             throws IOException,
                    AutomationException

Generates the Usage for a given tool.

Product Availability

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

Supported Platforms

Windows

Specified by:

usage in interface IGpDispatch

Parameters:

method - The method (in)

Returns:

The usage

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

exists

public boolean exists(Object pInputValue,
                      Object dataType)
               throws IOException,
                      AutomationException

Checks if a data element exists.

Product Availability

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

Supported Platforms

Windows

Specified by:

exists in interface IGpDispatch

Parameters:

pInputValue - A Variant (in)

dataType - A Variant (in, optional, pass null if not required)

Returns:

The exists

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

refreshCatalog

public void refreshCatalog(Object pInputValue)
                    throws IOException,
                           AutomationException

Refreshes the parent of the specified object in the catalog object associated with the Geoprocessor.

Product Availability

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

Supported Platforms

Windows

Specified by:

refreshCatalog in interface IGpDispatch

Parameters:

pInputValue - A Variant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

listFeatureClasses

public Object listFeatureClasses(Object wildCard,
                                 Object featureType,
                                 Object dataset)
                          throws IOException,
                                 AutomationException

Returns a collection of feature classes in the current workspace or optional dataset, based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:

listFeatureClasses in interface IGpDispatch

Parameters:

wildCard - A Variant (in, optional, pass null if not required)

featureType - A Variant (in, optional, pass null if not required)

dataset - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

listDatasets

public Object listDatasets(Object wildCard,
                           Object featureType)
                    throws IOException,
                           AutomationException

Returns a collection of datasets in the current workspace based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:

listDatasets in interface IGpDispatch

Parameters:

wildCard - A Variant (in, optional, pass null if not required)

featureType - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

listTables

public Object listTables(Object wildCard,
                         Object tableType)
                  throws IOException,
                         AutomationException

Returns a collection of tables in the current workspace based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:

listTables in interface IGpDispatch

Parameters:

wildCard - A Variant (in, optional, pass null if not required)

tableType - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

listRasters

public Object listRasters(Object wildCard,
                          Object rasterType)
                   throws IOException,
                          AutomationException

Returns a collection of rasters in the current workspace based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:

listRasters in interface IGpDispatch

Parameters:

wildCard - A Variant (in, optional, pass null if not required)

rasterType - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

listWorkspaces

public Object listWorkspaces(Object wildCard,
                             Object workspaceType)
                      throws IOException,
                             AutomationException

Returns a collection of workspaces in the current workspace based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:

listWorkspaces in interface IGpDispatch

Parameters:

wildCard - A Variant (in, optional, pass null if not required)

workspaceType - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

listFields

public Object listFields(Object pInputValue,
                         Object wildCard,
                         Object fieldType)
                  throws IOException,
                         AutomationException

Returns a collection of fields in the given table/feature class based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:

listFields in interface IGpDispatch

Parameters:

pInputValue - A Variant (in)

wildCard - A Variant (in, optional, pass null if not required)

fieldType - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

listIndexes

public Object listIndexes(Object pInputValue,
                          Object wildCard)
                   throws IOException,
                          AutomationException

Returns a collection of indexes in the given table/feature class based on a query string and type.

Product Availability

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

Supported Platforms

Windows

Specified by:

listIndexes in interface IGpDispatch

Parameters:

pInputValue - A Variant (in)

wildCard - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

searchCursor

public Object searchCursor(Object pInputValue,
                           Object whereClause,
                           Object spRef,
                           Object fields,
                           Object sortFields)
                    throws IOException,
                           AutomationException

Returns a search cursor object against the given table/feature class.

Product Availability

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

Supported Platforms

Windows

Specified by:

searchCursor in interface IGpDispatch

Parameters:

pInputValue - A Variant (in)

whereClause - A Variant (in, optional, pass null if not required)

spRef - A Variant (in, optional, pass null if not required)

fields - A Variant (in, optional, pass null if not required)

sortFields - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

updateCursor

public Object updateCursor(Object pInputValue,
                           Object whereClause,
                           Object spRef,
                           Object fields,
                           Object sortFields)
                    throws IOException,
                           AutomationException

Returns an update cursor object against the given table/feature class.

Product Availability

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

Supported Platforms

Windows

Specified by:

updateCursor in interface IGpDispatch

Parameters:

pInputValue - A Variant (in)

whereClause - A Variant (in, optional, pass null if not required)

spRef - A Variant (in, optional, pass null if not required)

fields - A Variant (in, optional, pass null if not required)

sortFields - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

insertCursor

public Object insertCursor(Object pInputValue,
                           Object spRef)
                    throws IOException,
                           AutomationException

Returns an insert cursor object against the given table/feature class.

Product Availability

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

Supported Platforms

Windows

Specified by:

insertCursor in interface IGpDispatch

Parameters:

pInputValue - A Variant (in)

spRef - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

describe

public Object describe(Object pInputValue,
                       Object dataType)
                throws IOException,
                       AutomationException

Returns a descriptor object describing the properties of the specified data element.

Product Availability

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

Supported Platforms

Windows

Specified by:

describe in interface IGpDispatch

Parameters:

pInputValue - A Variant (in)

dataType - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createObject

public Object createObject(Object pObjectName,
                           Object pExtraArg)
                    throws IOException,
                           AutomationException

Creates a geoprocessing object that can be used in a scripting environment.

Product Availability

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

Supported Platforms

Windows

Specified by:

createObject in interface IGpDispatch

Parameters:

pObjectName - A Variant (in)

pExtraArg - A Variant (in, optional, pass null if not required)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createRandomValueGenerator

public Object createRandomValueGenerator(int seed,
                                         String distributionType)
                                  throws IOException,
                                         AutomationException

Creates a geoprocessing random number generator object that can be used to generate random numbers.

Product Availability

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

Specified by:

createRandomValueGenerator in interface IGpDispatch

Parameters:

seed - The seed (in)

distributionType - The distributionType (in)

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setOverwriteOutput

public void setOverwriteOutput(boolean overwriteOutput)
                        throws IOException,
                               AutomationException

Indicates whether or not outputs should be overwritten.

Product Availability

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

Supported Platforms

Windows

Specified by:

setOverwriteOutput in interface IGpDispatch

Parameters:

overwriteOutput - The overwriteOutput (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isOverwriteOutput

public boolean isOverwriteOutput()
                          throws IOException,
                                 AutomationException

Indicates whether or not outputs should be overwritten.

Product Availability

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

Supported Platforms

Windows

Specified by:

isOverwriteOutput in interface IGpDispatch

Returns:

The overwriteOutput

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setLogHistory

public void setLogHistory(boolean logHistory)
                   throws IOException,
                          AutomationException

Indicates whether or not operations are logged or not.

Product Availability

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

Specified by:

setLogHistory in interface IGpDispatch

Parameters:

logHistory - The logHistory (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isLogHistory

public boolean isLogHistory()
                     throws IOException,
                            AutomationException

Indicates whether or not operations are logged or not.

Product Availability

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

Specified by:

isLogHistory in interface IGpDispatch

Returns:

The logHistory

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

validateFieldName

public String validateFieldName(String inputFieldName,
                                Object workspace)
                         throws IOException,
                                AutomationException

Checks a field for compatibility with the workspace.

Product Availability

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

Supported Platforms

Windows

Specified by:

validateFieldName in interface IGpDispatch

Parameters:

inputFieldName - The inputFieldName (in)

workspace - A Variant (in, optional, pass null if not required)

Returns:

The outputFieldName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

validateTableName

public String validateTableName(String inputTableName,
                                Object workspace)
                         throws IOException,
                                AutomationException

Checks a table name for compatibility with the workspace.

Product Availability

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

Supported Platforms

Windows

Specified by:

validateTableName in interface IGpDispatch

Parameters:

inputTableName - The inputTableName (in)

workspace - A Variant (in, optional, pass null if not required)

Returns:

The outputTableName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

qualifyFieldName

public String qualifyFieldName(String inputFieldName,
                               Object workspace)
                        throws IOException,
                               AutomationException

Qualifies a field name for the workspace and connected user.

Product Availability

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

Supported Platforms

Windows

Specified by:

qualifyFieldName in interface IGpDispatch

Parameters:

inputFieldName - The inputFieldName (in)

workspace - A Variant (in, optional, pass null if not required)

Returns:

The outputFieldName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

qualifyTableName

public String qualifyTableName(String inputTableName,
                               Object workspace)
                        throws IOException,
                               AutomationException

Qualifies a table name for the workspace and connected user.

Product Availability

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

Supported Platforms

Windows

Specified by:

qualifyTableName in interface IGpDispatch

Parameters:

inputTableName - The inputTableName (in)

workspace - A Variant (in, optional, pass null if not required)

Returns:

The outputTableName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

parseFieldName

public String parseFieldName(String inputFieldName,
                             Object workspace)
                      throws IOException,
                             AutomationException

Parses a field name into its constituent parts.

Product Availability

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

Supported Platforms

Windows

Specified by:

parseFieldName in interface IGpDispatch

Parameters:

inputFieldName - The inputFieldName (in)

workspace - A Variant (in, optional, pass null if not required)

Returns:

The outputParsedName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

parseTableName

public String parseTableName(String inputTableName,
                             Object workspace)
                      throws IOException,
                             AutomationException

Parses a table name into its constituent parts.

Product Availability

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

Supported Platforms

Windows

Specified by:

parseTableName in interface IGpDispatch

Parameters:

inputTableName - The inputTableName (in)

workspace - A Variant (in, optional, pass null if not required)

Returns:

The outputParsedName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createScratchName

public String createScratchName(Object prefix,
                                Object suffix,
                                Object dataType,
                                Object workspace)
                         throws IOException,
                                AutomationException

Creates a scratch name for the given workspace.

Product Availability

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

Specified by:

createScratchName in interface IGpDispatch

Parameters:

prefix - A Variant (in, optional, pass null if not required)

suffix - A Variant (in, optional, pass null if not required)

dataType - A Variant (in, optional, pass null if not required)

workspace - A Variant (in, optional, pass null if not required)

Returns:

The outputTableName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createUniqueName

public String createUniqueName(String inputTableName,
                               Object workspace)
                        throws IOException,
                               AutomationException

Creates a unique name for the given workspace.

Product Availability

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

Specified by:

createUniqueName in interface IGpDispatch

Parameters:

inputTableName - The inputTableName (in)

workspace - A Variant (in, optional, pass null if not required)

Returns:

The outputTableName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

saveSettings

public void saveSettings(String fileName)
                  throws IOException,
                         AutomationException

Saves the current GeoProcessor environment settings.

Product Availability

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

Specified by:

saveSettings in interface IGpDispatch

Parameters:

fileName - The fileName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

loadSettings

public void loadSettings(String fileName)
                  throws IOException,
                         AutomationException

Loads the current GeoProcessor environment settings.

Product Availability

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

Specified by:

loadSettings in interface IGpDispatch

Parameters:

fileName - The fileName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

testSchemaLock

public String testSchemaLock(String fileName)
                      throws IOException,
                             AutomationException

Tests if an exclusive schema lock is set on a dataset.

Product Availability

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

Specified by:

testSchemaLock in interface IGpDispatch

Parameters:

fileName - The fileName (in)

Returns:

The status

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

clearEnvironment

public void clearEnvironment(String env)
                      throws IOException,
                             AutomationException

Clears the value of a given environment.

Product Availability

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

Specified by:

clearEnvironment in interface IGpDispatch

Parameters:

env - The env (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

resetEnvironments

public void resetEnvironments()
                       throws IOException,
                              AutomationException

Tests if a given environments value is set or not.

Product Availability

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

Specified by:

resetEnvironments in interface IGpDispatch

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.