com.esri.arcgis.carto
Class ConvertLabelsToAnnotation

java.lang.Object
  com.esri.arcgis.carto.ConvertLabelsToAnnotation

All Implemented Interfaces:

IConvertLabelsToAnnotation, com.esri.arcgis.interop.RemoteObjRef, ISupportErrorInfo, Serializable

public class ConvertLabelsToAnnotation
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IConvertLabelsToAnnotation, ISupportErrorInfo

An ESRI convert labels to annotation helper class.

Remarks

ConvertLabelsToAnnotation is a coarse grained object that simplifies the process of converting labels to annotation. Conversion to Geodatabase or Map Annotation is supported via the object. See IConvertLabelsToAnnotation for more information on how to setup a conversion.

Product Availability

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

See Also:

Serialized Form

Constructor Summary

ConvertLabelsToAnnotation()
Constructs a ConvertLabelsToAnnotation using ArcGIS Engine.

ConvertLabelsToAnnotation(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
ConvertLabelsToAnnotation theConvertLabelsToAnnotation = (ConvertLabelsToAnnotation) obj;

Method Summary

void	addFeatureLayer(IFeatureLayer pFeatureLayer, String annoLayerName, IFeatureWorkspace pFeatureWorkspace, IFeatureDataset pFeatureDataset, boolean featureLinked, boolean appendMode, boolean requireSymbolID, boolean autoCreate, boolean autoUpdate, String configKeyword) Call this method for each feature layer be converted to annotation.
void	convertLabels() Convert labels to annotation.
boolean	equals(Object o) Compare this object with another
IEnumLayer	getAnnoLayers() New database annotation layers created by the conversion process.
static String	getClsid() getClsid.
String	getErrorInfo() Error information generated by the conversion process.
int	hashCode() the hashcode for this object
void	initialize(IMap pMap, int storageType, int whichFeatures, boolean generateUnplacedAnnotation, ITrackCancel pTrackCancel, IAnnotationErrorEvents pAnnotationErrorEvents) Call this method first to initialize the converter.
void	interfaceSupportsErrorInfo(GUID riid) interfaceSupportsErrorInfo

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef

getJintegraDispatch, release

Constructor Detail

ConvertLabelsToAnnotation

public ConvertLabelsToAnnotation()
                          throws IOException,
                                 UnknownHostException

Constructs a ConvertLabelsToAnnotation using ArcGIS Engine.

Throws:

IOException - if there are interop problems

UnknownHostException - if there are interop problems

ConvertLabelsToAnnotation

public ConvertLabelsToAnnotation(Object obj)
                          throws IOException

Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
ConvertLabelsToAnnotation theConvertLabelsToAnnotation = (ConvertLabelsToAnnotation) obj;

Construct a ConvertLabelsToAnnotation using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to ConvertLabelsToAnnotation.

Parameters:

obj - an object returned from ArcGIS Engine or Server

Throws:

IOException - if there are interop problems

Method Detail

getClsid

public static String getClsid()

getClsid.

equals

public boolean equals(Object o)

Compare this object with another

Overrides:

equals in class Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:

hashCode in class Object

initialize

public void initialize(IMap pMap,
                       int storageType,
                       int whichFeatures,
                       boolean generateUnplacedAnnotation,
                       ITrackCancel pTrackCancel,
                       IAnnotationErrorEvents pAnnotationErrorEvents)
                throws IOException,
                       AutomationException

Call this method first to initialize the converter.

Remarks

This method initializes the conversion object with the global parameters for conversion. It is the first method that should be called when using the ConvertLabelsToAnnotation object. The initialization has the following inputs:

• A reference to the Map you wish to convert labels from
• The storage type for the output annotation specified as an esriAnnotationStorageType value.
• Which features you would like to convert specified as an esriLabelWhichFeatures value.
• The option to generate unplaced annotation (True or False)
• A reference to cancel tracker
• Optionally, a reference to an error event handler.

Product Availability

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

Specified by:

initialize in interface IConvertLabelsToAnnotation

Parameters:

pMap - A reference to a com.esri.arcgis.carto.IMap (in)

storageType - A com.esri.arcgis.carto.esriAnnotationStorageType constant (in)

whichFeatures - A com.esri.arcgis.carto.esriLabelWhichFeatures constant (in)

generateUnplacedAnnotation - The generateUnplacedAnnotation (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

pAnnotationErrorEvents - A reference to a com.esri.arcgis.carto.IAnnotationErrorEvents (in, optional, pass 0 if not required)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addFeatureLayer

public void addFeatureLayer(IFeatureLayer pFeatureLayer,
                            String annoLayerName,
                            IFeatureWorkspace pFeatureWorkspace,
                            IFeatureDataset pFeatureDataset,
                            boolean featureLinked,
                            boolean appendMode,
                            boolean requireSymbolID,
                            boolean autoCreate,
                            boolean autoUpdate,
                            String configKeyword)
                     throws IOException,
                            AutomationException

Call this method for each feature layer be converted to annotation.

Remarks

This method adds a layer to the list of layers for which labels will be converted into annotation. Initialize should be called on the ConvertLabelsToAnnotation object before calling this method. This method may be called multiple times for one conversion when more that one layer will be converted.

Depending on the storage type chosen in initialize, some of the input parameters are optional. For map annotation, input the following items:

~ A reference to the feature layer the labels will be converted from
~ The name of the annotation group that will added to the map
~ For geodatabase annotation, input the following items:
~ A reference to the feature layer the labels will be converted from
~ The name of the annotation feature class that will either be created or appended to (see the append mode section below for more information)
~ The workspace the annotation feature class will reside in
~ The feature dataset the annotation feature class will reside in
~ The option to create feature linked annotation or not (True or False)
~ The option to append to an existing class or not (True or False). See the note about append below for more information.
~ The option on whether or not the created annotation feature class should require that elements reference a symbol in the symbol collection. (This option is not used if append mode = True).
~ The option on whether or not the annotation feature class should auto create new annotation features when a related feature is created (This option is not used if append mode = True and only applies for feature-linked annotation).
~ The option on whether or not the annotation feature class should auto update exiting annotation features when a related feature shape is changed (This option is not used if append mode = True and only applies for feature-linked annotation).
~ The configuration keyword to create the feature class with (This option is not used if append mode = True).

Append Mode:

If appendMode is True, the converter will look for the provided annotation class name in the specified workspace/feature dataset and convert labels to annotation features in that feature class. Append mode also performs additional logic to match existing annotation classes in the feature class with label classes being converted. If the classes match, they will be used rather than added to the annotation feature class extensions properties collection. If updates to the class extension are needed, an exclusive schema lock is required and an attempt will be made to obtain one.

If appendMode is false, a new annotation feature class will be created in specified workspace and feature dataset with the specified name and parameters as listed above.

Product Availability

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

Specified by:

addFeatureLayer in interface IConvertLabelsToAnnotation

Parameters:

pFeatureLayer - A reference to a com.esri.arcgis.carto.IFeatureLayer (in)

annoLayerName - The annoLayerName (in)

pFeatureWorkspace - A reference to a com.esri.arcgis.geodatabase.IFeatureWorkspace (in, optional, pass 0 if not required)

pFeatureDataset - A reference to a com.esri.arcgis.geodatabase.IFeatureDataset (in, optional, pass 0 if not required)

featureLinked - The featureLinked (in, optional, pass false if not required)

appendMode - The appendMode (in, optional, pass false if not required)

requireSymbolID - The requireSymbolID (in, optional, pass false if not required)

autoCreate - The autoCreate (in, optional, pass false if not required)

autoUpdate - The autoUpdate (in, optional, pass false if not required)

configKeyword - The configKeyword (in, optional, pass if not required)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

convertLabels

public void convertLabels()
                   throws IOException,
                          AutomationException

Convert labels to annotation.

Remarks

The ConvertLabels method is used to perform the conversion process after the object has been initialized via the Initialize method and the layers have been added via AddFeatureLayer. ConvertLabels automatically adds map annotation to the map. Geodatabase annotation layers are not automatically added to the map and are instead provided in an enumeration via the AnnoLayers property.

Product Availability

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

Specified by:

convertLabels in interface IConvertLabelsToAnnotation

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getAnnoLayers

public IEnumLayer getAnnoLayers()
                         throws IOException,
                                AutomationException

New database annotation layers created by the conversion process.

Remarks

Following the ConvertLabels method, geodatabase annotation layers are returned via this property.

Product Availability

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

Specified by:

getAnnoLayers in interface IConvertLabelsToAnnotation

Returns:

A reference to a com.esri.arcgis.carto.IEnumLayer

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getErrorInfo

public String getErrorInfo()
                    throws IOException,
                           AutomationException

Error information generated by the conversion process.

Remarks

This property returns a string of error information resulting from the conversion.

Product Availability

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

Specified by:

getErrorInfo in interface IConvertLabelsToAnnotation

Returns:

The info

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

interfaceSupportsErrorInfo

public void interfaceSupportsErrorInfo(GUID riid)
                                throws IOException,
                                       AutomationException

interfaceSupportsErrorInfo

Description

Indicates whether the interface supports IErrorInfo.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

interfaceSupportsErrorInfo in interface ISupportErrorInfo

Parameters:

riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.