Margin (DwgMarginLeaderControl) - Intergraph Smart 3D - Reference Data

Intergraph Smart 3D Drawings and Reports Reference Data

PPMProductFamily
3D Design and Visualization
PPMProduct
Intergraph Smart 3D
PPMCategory
Reference Data
Version_S3D
12.x(2018)

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
2 - Leader length
3 - Jog segment offset
4 - Jog segment offset 1
5 - Jog segment offset 2
6 - Perimeter 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
2 - Leader length
3 - Jog segment offset
4 - Perimeter 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>
<connectToNewestTextBox>-1</connectToNewestTextBox>
</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
2 - 0.03 m Leader Length
3 - Leader line

1 - Matchline
2 - 0.05 m Leader Length
3 - Leader line

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.

connectToNewestTextBox

Controls whether the leader line originates from the newest text box or the oldest text box in a compound label.

Examples

In the following example, leaderOffset is not enabled.

In the following example, leaderOffset is enabled with the default value.