com.esri.arcgis.geoprocessing
Interface IGPToolExtensionFactory

All Superinterfaces:

Serializable

All Known Implementing Classes:

FMEToolFactory, IGPToolExtensionFactoryProxy

public interface IGPToolExtensionFactory
extends Serializable

Provides access to methods on a geoprocessing tool extension factory object.

Product Availability

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

Method Summary

boolean	canEdit() Returns whether or not the factory supports editing instances of the tool extension.
IGPToolExtension	create(int parent, IGPToolbox destination, String[] defaultName, String[] defaultDisplayName, String[] defaultDescription) Creates a new instance of a tool extension in the given toolbox.
void	edit(int parent, IGPToolExtension toolExtension) Invokes a window to edit a tool extension.
IUID	getCLSID() The CLSID of the tool extension factory class.
int	getLargeImage() A 32x32 bitmap to associate with the tool extension.
int	getLargeInvalidImage() A 32x32 bitmap to associate with invalid instances of the tool extension.
int	getLargeUnlicensedImage() A 32x32 bitmap to associate with unlicensed instances of the tool extension.
int	getSmallImage() A 16x16 bitmap to associate with the tool extension.
int	getSmallInvalidImage() A 16x16 bitmap to associate with invalid instances of the tool extension.
int	getSmallUnlicensedImage() A 16x16 bitmap to associate with unlicensed instances of the tool extension.
String	getToolExtensionName() Name of the tool extension factory class.
void	postCreateTool(int parent, IGPToolExtension toolExtension) Called immediately following the creation of a new tool extension.

Method Detail

getCLSID

IUID getCLSID()
              throws IOException,
                     AutomationException

The CLSID of the tool extension factory class.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.system.IUID

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getToolExtensionName

String getToolExtensionName()
                            throws IOException,
                                   AutomationException

Name of the tool extension factory class.

Product Availability

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

Returns:

The name

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSmallImage

int getSmallImage()
                  throws IOException,
                         AutomationException

A 16x16 bitmap to associate with the tool extension.

Product Availability

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

Returns:

The image (A COM typedef)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLargeImage

int getLargeImage()
                  throws IOException,
                         AutomationException

A 32x32 bitmap to associate with the tool extension.

Product Availability

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

Returns:

The image (A COM typedef)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSmallInvalidImage

int getSmallInvalidImage()
                         throws IOException,
                                AutomationException

A 16x16 bitmap to associate with invalid instances of the tool extension.

Product Availability

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

Returns:

The image (A COM typedef)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLargeInvalidImage

int getLargeInvalidImage()
                         throws IOException,
                                AutomationException

A 32x32 bitmap to associate with invalid instances of the tool extension.

Product Availability

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

Returns:

The image (A COM typedef)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSmallUnlicensedImage

int getSmallUnlicensedImage()
                            throws IOException,
                                   AutomationException

A 16x16 bitmap to associate with unlicensed instances of the tool extension.

Product Availability

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

Returns:

The image (A COM typedef)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLargeUnlicensedImage

int getLargeUnlicensedImage()
                            throws IOException,
                                   AutomationException

A 32x32 bitmap to associate with unlicensed instances of the tool extension.

Product Availability

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

Returns:

The image (A COM typedef)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

create

IGPToolExtension create(int parent,
                        IGPToolbox destination,
                        String[] defaultName,
                        String[] defaultDisplayName,
                        String[] defaultDescription)
                        throws IOException,
                               AutomationException

Creates a new instance of a tool extension in the given toolbox.

Product Availability

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

Parameters:

parent - The parent (A COM typedef) (in)

destination - A reference to a com.esri.arcgis.geoprocessing.IGPToolbox (in)

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

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

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

Returns:

A reference to a com.esri.arcgis.geoprocessing.IGPToolExtension

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

postCreateTool

void postCreateTool(int parent,
                    IGPToolExtension toolExtension)
                    throws IOException,
                           AutomationException

Called immediately following the creation of a new tool extension.

Product Availability

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

Parameters:

parent - The parent (A COM typedef) (in)

toolExtension - A reference to a com.esri.arcgis.geoprocessing.IGPToolExtension (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

canEdit

boolean canEdit()
                throws IOException,
                       AutomationException

Returns whether or not the factory supports editing instances of the tool extension.

Product Availability

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

Returns:

The canEdit

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

edit

void edit(int parent,
          IGPToolExtension toolExtension)
          throws IOException,
                 AutomationException

Invokes a window to edit a tool extension.

Product Availability

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

Parameters:

parent - The parent (A COM typedef) (in)

toolExtension - A reference to a com.esri.arcgis.geoprocessing.IGPToolExtension (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.