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.

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.