FabricationPart.AlignPartByInsertionPoint
Method
Description:
Align the part by its insertion point to a point and rotation in free space.
Align the part by its insertion point to a point and rotation in free space.
Syntax
public static bool AlignPartByInsertionPoint(
Document document,
ElementId partId,
XYZ position,
double rotation,
double rotationPerpendicular,
double slope,
FabricationPartJustification justification,
Transform trf
)
Parameters
Parameter | Type | Description |
---|---|---|
document | Document | The document. |
partId | ElementId | The element identifier of the part to align. |
position | XYZ | The position to move the part's insertion point to. |
rotation | Double | The rotation in radians. |
rotationPerpendicular | Double | The perpendicular rotation for free placement around the Y axis direction of connection - angle in radians. |
slope | Double | The slope value to flex to match if possible in fractional units (eg.1/50). Positive values are up, negative are down. Slopes can only be applied to fittings, whilst straights will inherit the slope from the piece it is connecting to. |
justification | FabricationPartJustification | The justification to align eccentric parts. |
trf | Transform | Optional alignment transformation matrix, eg. a Trf that describes plan or side elevation. |
Return Value
Type | Description |
---|---|
Boolean | True if the alignment succeeds, false otherwise. |
Exceptions
Exception | Condition |
---|---|
ArgumentException | The element is not a fabrication part. -or- Not all of the fabrication part's connectors are open. |
ArgumentNullException | A non-optional argument was null |
ArgumentOutOfRangeException | A value passed for an enumeration argument is not a member of that enumeration |