com.esri.arcgis.geoprocessing
Interface IGPToolExtensionFactoryGen

All Superinterfaces:

Serializable

All Known Implementing Classes:

IGPToolExtensionFactoryGenProxy

public interface IGPToolExtensionFactoryGen
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.
IGPToolExtensionGen	create(int parent, IGPToolbox destination) Creates a new instance of a tool extension in the given toolbox.
void	edit(int parent, IGPToolExtensionGen toolExtension) Invokes a window to edit a tool extension.
IUID	getCLSID() The CLSID of the tool extension factory class.
String	getDefaultDescription() The default tool extension description.
String	getDefaultDisplayName() The default tool extension display name.
String	getDefaultName() The default tool extension name.
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, IGPToolExtensionGen 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.

getDefaultName

String getDefaultName()
                      throws IOException,
                             AutomationException

The default tool extension name.

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.

getDefaultDisplayName

String getDefaultDisplayName()
                             throws IOException,
                                    AutomationException

The default tool extension display name.

Product Availability

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

Returns:

The displayName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDefaultDescription

String getDefaultDescription()
                             throws IOException,
                                    AutomationException

The default tool extension description.

Product Availability

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

Returns:

The description

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

create

IGPToolExtensionGen create(int parent,
                           IGPToolbox destination)
                           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)

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

postCreateTool

void postCreateTool(int parent,
                    IGPToolExtensionGen 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.IGPToolExtensionGen (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,
          IGPToolExtensionGen 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.IGPToolExtensionGen (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.