Revit 2025 API
Fabrication |
Align the part by its insertion point to a point and rotation in free space.
Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)
Syntax
public static bool AlignPartByInsertionPoint( Document document, ElementId partId, XYZ position, double rotation, double rotationPerpendicular, double slope, FabricationPartJustification justification, Transform trf )
Public Shared Function AlignPartByInsertionPoint ( document As Document, partId As ElementId, position As XYZ, rotation As Double, rotationPerpendicular As Double, slope As Double, justification As FabricationPartJustification, trf As Transform ) As Boolean
public: static bool AlignPartByInsertionPoint( Document^ document, ElementId^ partId, XYZ^ position, double rotation, double rotationPerpendicular, double slope, FabricationPartJustification justification, Transform^ trf )
static member AlignPartByInsertionPoint : document : Document * partId : ElementId * position : XYZ * rotation : float * rotationPerpendicular : float * slope : float * justification : FabricationPartJustification * trf : Transform -> bool
Parameters
- 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
BooleanTrue if the alignment succeeds, false otherwise.

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 |
See Also