Associated Object of Dim/Draft Object

Synopsis

ASCENT/obj,n,assoc. obj [,assoc. type, assoc.modifier][,IFERR,label:]

Description

Obtains the object identifier of the nth associated object of a dimension/drafting object, and its associativity type and modifier.

If the specified object is not a dimension/drafting object, an error occurs.

Parameters

Parameter

Description

obj

An existing dimension/drafting object to which the associated object is related.

n

A numeric variable which specifies the desired nth associated object.

assoc. obj

An object variable which is assigned with the object identifier of the associated object.

assoc. type

A numeric variable which is assigned with the associativity type of the associated object. The possible values of the associativity type are as follows:

1 – Endpoint of line or curve
2 – Center of arc or circle
3 – Tangent to arc or circle
4 – Normal to curve
5 – Param % on line or curve
6 – Coordinates on drawing (there are no associated geometric objects)
7 – Intersection
9 – Utility Symbol (e.g. centerline)

assoc. modifier

A numeric variable which is assigned with the associativity modifier of the associated object. The associativity modifier is a numerical value which represents the percentage distance along the curve from its starting point, where 0 is the beginning of the curve and 1 is the end of the curve. For example, a numerical value of .75 represents 3/4 of the total curve length. For the usage of the modifier, see the CPOSF statement.

IFERR,label:

Specifies a label to which program execution jumps if an error occurs.

Parameter	Description
obj	An existing dimension/drafting object to which the associated object is related.
n	A numeric variable which specifies the desired nth associated object.
assoc. obj	An object variable which is assigned with the object identifier of the associated object.
assoc. type	A numeric variable which is assigned with the associativity type of the associated object. The possible values of the associativity type are as follows: 1 – Endpoint of line or curve 2 – Center of arc or circle 3 – Tangent to arc or circle 4 – Normal to curve 5 – Param % on line or curve 6 – Coordinates on drawing (there are no associated geometric objects) 7 – Intersection 9 – Utility Symbol (e.g. centerline)
assoc. modifier	A numeric variable which is assigned with the associativity modifier of the associated object. The associativity modifier is a numerical value which represents the percentage distance along the curve from its starting point, where 0 is the beginning of the curve and 1 is the end of the curve. For example, a numerical value of .75 represents 3/4 of the total curve length. For the usage of the modifier, see the CPOSF statement.
IFERR,label:	Specifies a label to which program execution jumps if an error occurs.