com.esri.arcgis.carto
Interface IAnnotationExpressionEngine

All Superinterfaces:
Serializable
All Known Implementing Classes:
AnnotationJScriptEngine, AnnotationVBScriptEngine, HotLinkJScriptEngine, HotLinkVBScriptEngine

public interface IAnnotationExpressionEngine
extends Serializable

Provides access to members that work with low level information about a script based labeling expression.

When To Use

The IAnnotationExpressionEngine interface is implemented by the script engine coclasses. This is a low level interface maintaining information about the labeling expression.

The AppendCode property provides the language specific characters needed to append two strings.

The CreateFunction method creates a simple expression properly formatted for the parser language.

The SetCode and SetExpression are used to set the label expression into the parser. SetCode is used for adavanced expressions while SetExpression is used for simple expressions.

Product Availability

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

See Also:
ILabelEngineLayerProperties

Method Summary
 String createFunction(String name, String parameters, String expression)
          Creates the specified function.
 String getAppendCode()
          The code to append.
 String getName()
          The name of the expression engine.
 IAnnotationExpressionParser setCode(String fullCode, String runFunction)
          The function to base labels on.
 IAnnotationExpressionParser setExpression(String preCode, String expression)
          The expression to base labels on.
 

Method Detail

getName

String getName()
               throws IOException,
                      AutomationException
The name of the expression engine.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The expression
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getAppendCode

String getAppendCode()
                     throws IOException,
                            AutomationException
The code to append.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The appendCode
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createFunction

String createFunction(String name,
                      String parameters,
                      String expression)
                      throws IOException,
                             AutomationException
Creates the specified function.

Remarks

The CreateFunction methods is used to convert a simple expression into an Advanced Expression.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
name - The name (in)
parameters - The parameters (in)
expression - The expression (in)
Returns:
The function
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setExpression

IAnnotationExpressionParser setExpression(String preCode,
                                          String expression)
                                          throws IOException,
                                                 AutomationException
The expression to base labels on.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setCode

IAnnotationExpressionParser setCode(String fullCode,
                                    String runFunction)
                                    throws IOException,
                                           AutomationException
The function to base labels on.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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