Provides access to members that control placement position priorities for line labels.
Product Availability
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.
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.
Members
Description | ||
---|---|---|
AboveAfter | Label position priority for above and after the line. | |
AboveAlong | Label position priority for above and along the line. | |
AboveBefore | Label position priority for above and before the line. | |
AboveEnd | Label position priority for above and at the end of the line. | |
AboveStart | Label position priority for above and at the start of the line. | |
BelowAfter | Label position priority for below and after the line. | |
BelowAlong | Label position priority for below and along the line. | |
BelowBefore | Label position priority for below and before the line. | |
BelowEnd | Label position priority for below and at the end of the line. | |
BelowStart | Label position priority for below and at the start of the line. | |
CenterAfter | Label position priority for in the center and after the line. | |
CenterAlong | Label position priority for in the center and along the line. | |
CenterBefore | Label position priority for in the center and before the line. | |
CenterEnd | Label position priority for in the center and at the end of the line. | |
CenterStart | Label position priority for in the center and at the start of the line. |
CoClasses that implement ILineLabelPlacementPriorities
CoClasses and Classes | Description |
---|---|
LineLabelPlacementPriorities | Controls placement position priorities for line labels. |
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:
- 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.
- 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.
- 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.