com.esri.arcgis.carto
Interface ILabelCache

All Superinterfaces:

Serializable

All Known Implementing Classes:

LabelCache

public interface ILabelCache
extends Serializable

Provides access to members that control a label cache.

Remarks

This interface is not supported for customization and may be removed at a future release.

Product Availability

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

Method Summary

void	addClass(int classID, ILabelEngineLayerProperties pLayerProps) Add a class to the label cache.
void	addLabel(IPlacedObject3 placedObject, IPoint anchorPoint, IEnvelope pEnvelope) Add a label to the label cache.
void	empty() Empty label cache.
int	getClassCount() Number of classes in the cache.
void	getDisplaySettings(double[] scale, double[] dataframeRotation) Settings of the display transformation when cache was created.
void	getPlacedLabel(int index, int[] classID, String[] label, IGeometry[] geom, double[] angle, IPoint[] anchorPoint, IEnvelope[] mbr) Retrieve a placed label from the label cache.
int	getPlacedLabelCount() Number of placed labels stored the cache.
void	getUnplacedLabel(int index, int[] classID, String[] label, IGeometry[] geom, double[] angle, IPoint[] anchorPoint, IEnvelope[] mbr) Retrieve an unplaced label from the label cache.
int	getUnplacedLabelCount() Number of unplaced labels stored the cache.
void	init(IMap map) Initialize label cache.
void	putDisplaySettings(double scale, double dataframeRotation) Settings of the display transformation when cache was created.
void	queryClass(int index, int[] classID, String[] className, IFeatureLayer[] featureLayer, ITextSymbol[] textSymbol) Retrieve a class from the label cache.

Method Detail

init

void init(IMap map)
          throws IOException,
                 AutomationException

Initialize label cache.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

empty

void empty()
           throws IOException,
                  AutomationException

Empty label cache.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addClass

void addClass(int classID,
              ILabelEngineLayerProperties pLayerProps)
              throws IOException,
                     AutomationException

Add a class to the label cache.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

classID - The classID (in)

pLayerProps - A reference to a com.esri.arcgis.carto.ILabelEngineLayerProperties (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getClassCount

int getClassCount()
                  throws IOException,
                         AutomationException

Number of classes in the cache.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The count

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryClass

void queryClass(int index,
                int[] classID,
                String[] className,
                IFeatureLayer[] featureLayer,
                ITextSymbol[] textSymbol)
                throws IOException,
                       AutomationException

Retrieve a class from the label cache.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

index - The index (in)

classID - The classID (out: use single element array)

className - The className (out: use single element array)

featureLayer - A reference to a com.esri.arcgis.carto.IFeatureLayer (out: use single element array)

textSymbol - A reference to a com.esri.arcgis.display.ITextSymbol (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addLabel

void addLabel(IPlacedObject3 placedObject,
              IPoint anchorPoint,
              IEnvelope pEnvelope)
              throws IOException,
                     AutomationException

Add a label to the label cache.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

placedObject - A reference to a com.esri.arcgis.carto.IPlacedObject3 (in)

anchorPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)

pEnvelope - A reference to a com.esri.arcgis.geometry.IEnvelope (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getPlacedLabelCount

int getPlacedLabelCount()
                        throws IOException,
                               AutomationException

Number of placed labels stored the cache.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The count

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getPlacedLabel

void getPlacedLabel(int index,
                    int[] classID,
                    String[] label,
                    IGeometry[] geom,
                    double[] angle,
                    IPoint[] anchorPoint,
                    IEnvelope[] mbr)
                    throws IOException,
                           AutomationException

Retrieve a placed label from the label cache.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

index - The index (in)

classID - The classID (out: use single element array)

label - The label (out: use single element array)

geom - A reference to a com.esri.arcgis.geometry.IGeometry (out: use single element array)

angle - The angle (out: use single element array)

anchorPoint - A reference to a com.esri.arcgis.geometry.IPoint (out: use single element array)

mbr - A reference to a com.esri.arcgis.geometry.IEnvelope (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getUnplacedLabelCount

int getUnplacedLabelCount()
                          throws IOException,
                                 AutomationException

Number of unplaced labels stored the cache.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The count

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getUnplacedLabel

void getUnplacedLabel(int index,
                      int[] classID,
                      String[] label,
                      IGeometry[] geom,
                      double[] angle,
                      IPoint[] anchorPoint,
                      IEnvelope[] mbr)
                      throws IOException,
                             AutomationException

Retrieve an unplaced label from the label cache.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

index - The index (in)

classID - The classID (out: use single element array)

label - The label (out: use single element array)

geom - A reference to a com.esri.arcgis.geometry.IGeometry (out: use single element array)

angle - The angle (out: use single element array)

anchorPoint - A reference to a com.esri.arcgis.geometry.IPoint (out: use single element array)

mbr - A reference to a com.esri.arcgis.geometry.IEnvelope (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

putDisplaySettings

void putDisplaySettings(double scale,
                        double dataframeRotation)
                        throws IOException,
                               AutomationException

Settings of the display transformation when cache was created.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

scale - The scale (in)

dataframeRotation - The dataframeRotation (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDisplaySettings

void getDisplaySettings(double[] scale,
                        double[] dataframeRotation)
                        throws IOException,
                               AutomationException

Settings of the display transformation when cache was created.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

scale - The scale (out: use single element array)

dataframeRotation - The dataframeRotation (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.