ArcObjects Library Reference (Carto)  

ILineLabelPosition Interface

Provides access to members that control the relative position of line labels.

Product Availability

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

Description

The properties of this interface correspond to the settings on the label placement properties dialog in ArcMap for line features. These properties are also used for feature-linked annotation.

When To Use

Manages label placement properties for line features. For example, you can use this interface to specify whether labels can be placed above, below and/or centered on the line features being labeled.

Members

Description
Read/write property Above Indicates if labels are placed above lines.
Read/write property AtEnd Indicates if labels are placed at the end of lines.
Read/write property AtStart Indicates if labels are placed at the start of lines.
Read/write property Below Indicates if labels are placed below lines.
Read/write property Horizontal Indicates if labels are placed horizontally.
Read/write property InLine Indicates if labels are placed along lines at the best position.
Read/write property Left Indicates if labels are placed to the left of lines.
Read/write property Offset Offset from the start/end of lines (in map units).
Read/write property OnTop Indicates if labels are placed on top of lines.
Read/write property Parallel Indicates if labels are placed parallel to lines.
Read/write property Perpendicular Indicates if labels are placed perpendicular to lines.
Read/write property ProduceCurvedLabels Indicates if labels follow lines.
Read/write property Right Indicates if labels are placed to the right of lines.

CoClasses that implement ILineLabelPosition

CoClasses and Classes Description
LineLabelPosition Controls the relative positions of line labels.

Remarks

Not all property value combinations are valid in ArcMap, but no validation is performed by this object. This means that you can set the properties of this object to any combination of true/false and this object will not change them for you.

When labeling occurs in ArcMap, invalid property combinations on this object can create unexpected results.

Validation does occur when the ArcMap user interface is used (i.e. the label placement properties dialog). Changes applied here by the user will change the values set on the current object.

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. Several of these rules are described here:

See Also

IBasicOverposterLayerProperties Interface