com.esri.arcgis.system
Interface INameFactory

All Superinterfaces:
Serializable
All Known Implementing Classes:
NameFactory

public interface INameFactory
extends Serializable

Provides access to members that work with the Name factory.

Description

The INameFactory interface provides methods for packaging and unpackaging ESRI data objects when implementing your own custom drag and drop behaviour.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux


Method Summary
 IName create(String nameString)
          Finds the correct name-string parser for the given name string, and uses it to create a new Name object.
 Object packageNames(IEnumName names)
          Packages the set of names into a VARIANT (typically for initiating a drag operation).
 IEnumName unpackageNames(Object bytesArray)
          Unpackages the given VARIANT into a set of Name objects (typically for responding to a drop operation).
 

Method Detail

create

IName create(String nameString)
             throws IOException,
                    AutomationException
Finds the correct name-string parser for the given name string, and uses it to create a new Name object.

Description

The Create method creates a new Name object by searching the "ESRI Name String Parsers" component category for objects implementing IParseNameString. Once the correct name-string parser is found it is used to create the Name object.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

packageNames

Object packageNames(IEnumName names)
                    throws IOException,
                           AutomationException
Packages the set of names into a VARIANT (typically for initiating a drag operation).

Description

The PackageNames method packages a set of Name objects into a VARIANT. This is typically used to package data objects when starting a custom drag operation.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

unpackageNames

IEnumName unpackageNames(Object bytesArray)
                         throws IOException,
                                AutomationException
Unpackages the given VARIANT into a set of Name objects (typically for responding to a drop operation).

Description

The UnpackageNames method unpackages the given VARIANT into a set of Name objects. This is typically used to unpackage data objects when sresponding to a custom drop operation.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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