Places a multi-segment leader that you can use with grid lines and other linear objects. For labels that are located outside of the view, the software places the leader between the matchline and the jog segment.
1 - Leader offset |
Smart 3D only uses the Jog Segment Offset 1 and Jog Segment Offset 2 properties with the Clear Space Margin with Dimensions positioning module. For all other positioning modules, Margin produces a leader line that looks like the example below.
1 - Leader offset |
Usage in Label Template XML
<label>
<leaderSettings>
<leaderModule>DwgMarginLeaderControl</leaderModule>
<ignoreLeaderCrossings>-1</ignoreLeaderCrossings>
<disableAutoDelete>-1</disableAutoDelete>
<leaderOffset>0.002</leaderOffset>
<leaderLength>0.005</leaderLength>
<style>ANSI_NOARROW</style>
<jogSegmentOffset>0.015</jogSegmentOffset>
<jogSegmentOffset1>0.015</jogSegmentOffset1>
<jogSegmentOffset2>0.005<jogSegmentOffset2>
</leaderSettings>
</label>
Customization
ignoreLeaderCrossings
Renders the leader line of a label as invisible to other annotations.
Type -1 to allow leader lines and other annotations to intersect.
Type 0 to render the leader line visible to other annotations.
disableAutoDelete
Controls the visibility of the leader line of a label when the distance from the label to the corresponding connect point is less than half the label height.
Type -1 to retain the leader line.
1 - Label with leader line |
Type 0 to turn off the leader line.
1 - Label with no leader line |
leaderOffset
Specifies the distance outside of the matchline at which you want the leader line to terminate. If this value is zero, the leader line connects to the object.
The following example shows a leaderOffset of 0.001.
1 - Leader offset = 0.001 |
In the next example, the leaderOffset is set to zero.
1 - Leader offset = 0.0 |
leaderLength
Sets the distance from the matchline to the first jog in the leader line of a label when the leader line contains multiple segments. This property can be applied only if the leader line uses a breakline.
1 - Matchline |
1 - Matchline |
style
Defines the appearance of a leader line.
-
ANSI: Applies a thin, solid, dark cyan line style with a filled arrow terminator to the leader line.
-
ANSI_FRACTIONAL: Applies a thick, solid, dark cyan line style with a filled arrow terminator to the leader line.
-
ANSI_NOARROW: Applies a thick, solid, dark cyan line style with no terminator to the leader line.
-
JIS: Applies a thick, solid, dark cyan line style with a large, open arrow terminator to the leader line.
-
ISO: Applies a thick, solid, dark cyan line style with a large, filled arrow terminator to the leader line.
-
DIN: Applies a thick, solid, dark cyan line style with a large, filled arrow terminator to the leader line.
-
ASA: Applies a thick, solid, dark cyan line style with a filled arrow terminator to the leader line.
-
BSI: Applies a thick, solid, dark cyan line style with a large, filled arrow terminator to the leader line.
jogSegmentOffset
Allows you to specify the offset from the first leader segment connected to the object to the next jog segment in the leader line.
jogSegmentOffset1
Allows you to specify the offset from the end of the jog segment offset 1 to the jog segment offset 2 in a leader line.
jogSegmentOffset2
Allows you to specify the offset from jog offset 1 to the remaining portion of the leader line. The jog segment to which this property applies connects to the leader line that connects directly to the label.
Examples
In the following example, leaderOffset is not enabled.
In the following example, leaderOffset is enabled with the default value.