com.esri.arcgis.carto
Interface ILineLabelPlacementPriorities

All Superinterfaces:
Serializable
All Known Implementing Classes:
LineLabelPlacementPriorities

public interface ILineLabelPlacementPriorities
extends Serializable

Provides access to members that control placement position priorities for line labels.

Description

The properties of this interface correspond to the settings on the label start point and end point priorities dialogs in ArcMap. These properties are also used for feature-linked annotation.

Remarks

Not all properties of this interface are used when labeling in ArcMap. Whether or not properties are used depends on settings on ILineLabelPosition.

When setting properties using this interface, it is recommended that you use the ArcMap user interface logic as a guide to setting valid property combinations. These rules are also described here:

  1. ILineLabelPosition::Above and ILineLabelPosition::Left determine whether or not the properties that begin with "Above" on this object are used. If either of these are True, then these properties are used.
  2. ILineLabelPosition::OnTop determines whether or not the properties that begin with "Center" on this object are used. If this is True, then these properties are used.
  3. ILineLabelPosition::Below and ILineLabelPosition::Right determine whether or not the properties that begin with "Below" on this object are used. If either of these are True, then these properties are used.

When To Use

The ILineLabelPlacementPriorities interface maintains information about the placement alternatives of labels relative to line features. For example, use this interface to specify whether labels can be placed above, below or centered on lines.

Each available position is assigned a weight between 0-9. Zero (0) means that this position is not to be considered at all (blocked), whereas a position assigned the weight one (1) would be tried before two (2) and so on.

Product Availability

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

See Also:
IBasicOverposterLayerProperties

Method Summary
 int getAboveAfter()
          Label position priority for above and after the line.
 int getAboveAlong()
          Label position priority for above and along the line.
 int getAboveBefore()
          Label position priority for above and before the line.
 int getAboveEnd()
          Label position priority for above and at the end of the line.
 int getAboveStart()
          Label position priority for above and at the start of the line.
 int getBelowAfter()
          Label position priority for below and after the line.
 int getBelowAlong()
          Label position priority for below and along the line.
 int getBelowBefore()
          Label position priority for below and before the line.
 int getBelowEnd()
          Label position priority for below and at the end of the line.
 int getBelowStart()
          Label position priority for below and at the start of the line.
 int getCenterAfter()
          Label position priority for in the center and after the line.
 int getCenterAlong()
          Label position priority for in the center and along the line.
 int getCenterBefore()
          Label position priority for in the center and before the line.
 int getCenterEnd()
          Label position priority for in the center and at the end of the line.
 int getCenterStart()
          Label position priority for in the center and at the start of the line.
 void setAboveAfter(int priority)
          Label position priority for above and after the line.
 void setAboveAlong(int priority)
          Label position priority for above and along the line.
 void setAboveBefore(int priority)
          Label position priority for above and before the line.
 void setAboveEnd(int priority)
          Label position priority for above and at the end of the line.
 void setAboveStart(int priority)
          Label position priority for above and at the start of the line.
 void setBelowAfter(int priority)
          Label position priority for below and after the line.
 void setBelowAlong(int priority)
          Label position priority for below and along the line.
 void setBelowBefore(int priority)
          Label position priority for below and before the line.
 void setBelowEnd(int priority)
          Label position priority for below and at the end of the line.
 void setBelowStart(int priority)
          Label position priority for below and at the start of the line.
 void setCenterAfter(int priority)
          Label position priority for in the center and after the line.
 void setCenterAlong(int priority)
          Label position priority for in the center and along the line.
 void setCenterBefore(int priority)
          Label position priority for in the center and before the line.
 void setCenterEnd(int priority)
          Label position priority for in the center and at the end of the line.
 void setCenterStart(int priority)
          Label position priority for in the center and at the start of the line.
 

Method Detail

getAboveBefore

int getAboveBefore()
                   throws IOException,
                          AutomationException
Label position priority for above and before the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setAboveBefore

void setAboveBefore(int priority)
                    throws IOException,
                           AutomationException
Label position priority for above and before the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getAboveStart

int getAboveStart()
                  throws IOException,
                         AutomationException
Label position priority for above and at the start of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setAboveStart

void setAboveStart(int priority)
                   throws IOException,
                          AutomationException
Label position priority for above and at the start of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getAboveAlong

int getAboveAlong()
                  throws IOException,
                         AutomationException
Label position priority for above and along the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setAboveAlong

void setAboveAlong(int priority)
                   throws IOException,
                          AutomationException
Label position priority for above and along the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getAboveEnd

int getAboveEnd()
                throws IOException,
                       AutomationException
Label position priority for above and at the end of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setAboveEnd

void setAboveEnd(int priority)
                 throws IOException,
                        AutomationException
Label position priority for above and at the end of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getAboveAfter

int getAboveAfter()
                  throws IOException,
                         AutomationException
Label position priority for above and after the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setAboveAfter

void setAboveAfter(int priority)
                   throws IOException,
                          AutomationException
Label position priority for above and after the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCenterBefore

int getCenterBefore()
                    throws IOException,
                           AutomationException
Label position priority for in the center and before the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setCenterBefore

void setCenterBefore(int priority)
                     throws IOException,
                            AutomationException
Label position priority for in the center and before the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCenterStart

int getCenterStart()
                   throws IOException,
                          AutomationException
Label position priority for in the center and at the start of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setCenterStart

void setCenterStart(int priority)
                    throws IOException,
                           AutomationException
Label position priority for in the center and at the start of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCenterAlong

int getCenterAlong()
                   throws IOException,
                          AutomationException
Label position priority for in the center and along the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setCenterAlong

void setCenterAlong(int priority)
                    throws IOException,
                           AutomationException
Label position priority for in the center and along the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCenterEnd

int getCenterEnd()
                 throws IOException,
                        AutomationException
Label position priority for in the center and at the end of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setCenterEnd

void setCenterEnd(int priority)
                  throws IOException,
                         AutomationException
Label position priority for in the center and at the end of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCenterAfter

int getCenterAfter()
                   throws IOException,
                          AutomationException
Label position priority for in the center and after the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setCenterAfter

void setCenterAfter(int priority)
                    throws IOException,
                           AutomationException
Label position priority for in the center and after the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getBelowBefore

int getBelowBefore()
                   throws IOException,
                          AutomationException
Label position priority for below and before the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setBelowBefore

void setBelowBefore(int priority)
                    throws IOException,
                           AutomationException
Label position priority for below and before the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getBelowStart

int getBelowStart()
                  throws IOException,
                         AutomationException
Label position priority for below and at the start of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setBelowStart

void setBelowStart(int priority)
                   throws IOException,
                          AutomationException
Label position priority for below and at the start of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getBelowAlong

int getBelowAlong()
                  throws IOException,
                         AutomationException
Label position priority for below and along the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setBelowAlong

void setBelowAlong(int priority)
                   throws IOException,
                          AutomationException
Label position priority for below and along the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getBelowEnd

int getBelowEnd()
                throws IOException,
                       AutomationException
Label position priority for below and at the end of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setBelowEnd

void setBelowEnd(int priority)
                 throws IOException,
                        AutomationException
Label position priority for below and at the end of the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getBelowAfter

int getBelowAfter()
                  throws IOException,
                         AutomationException
Label position priority for below and after the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setBelowAfter

void setBelowAfter(int priority)
                   throws IOException,
                          AutomationException
Label position priority for below and after the line.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
priority - The priority (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.