com.esri.arcgis.system
Interface ICategoryFactory

All Superinterfaces:
Serializable
All Known Implementing Classes:
CategoryFactory

public interface ICategoryFactory
extends Serializable

Provides access to members that work with the category factory.

Description

Use the ICategoryFactory interface to read the information in the registry to find out what classes are in a particular category. The IComponentCategoryManager is used for writing component category information to the registry.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux


Method Summary
 Object createNext()
          Creates the next component in the category.
 void setCategoryID(IUID rhs1)
          The ID of the category.
 

Method Detail

setCategoryID

void setCategoryID(IUID rhs1)
                   throws IOException,
                          AutomationException
The ID of the category.

Description

Set the CategoryID to the GUID of the component category to be read.

Remarks

After the component category was specified with the CategoryID property, it points to the classes registered in that category. If more classes were added to that component category, and the CategoryID property is set second time to the same category to retrieve all registered classes including new ones, the CategoryID still points to the first state of the component category in the registry. No new classes could be retrieved in the same application runtime.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
rhs1 - A reference to a com.esri.arcgis.system.IUID (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createNext

Object createNext()
                  throws IOException,
                         AutomationException
Creates the next component in the category.

Description

The CreateNext method retrieves classes from the specified component category. Specify the category with the CategoryID property.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to another Object (IUnknown)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.