SpliceRebar(Document, ElementId, RebarSpliceOptions, Line, XYZ) Method


Rebar Splice Utils Splice Rebar(Document, Element Id, Rebar Splice Options, Line, XYZ) Method

Splice a rebar with a line.

Namespace: Autodesk.Revit.DB.Structure
Assembly: RevitAPI (in RevitAPI.dll) Version: 27.0.4.0 (27.0.4.0)
Syntax
public static IList<ElementId> SpliceRebar(
	Document document,
	ElementId rebarIdToSplice,
	RebarSpliceOptions spliceOptions,
	Line line,
	XYZ linePlaneNormal
)

Parameters

document Document
The document
rebarIdToSplice ElementId
Rebar id to splice.
spliceOptions RebarSpliceOptions
The rebar splice options.
line Line
The line used for splice.
linePlaneNormal XYZ
The normal of the plane of the line.

Return Value

IList ElementId
Returns the ids of the rebars that are considered to be spliced.
Exceptions
Exception Condition
ArgumentException Free Form Rebars other than Morphed, or Shape Driven Rebars that are Multiplanar or have a shape whose definition is RebarShapeDefinitionByArc can't be spliced. Also, if the Rebar is member of a Group it cannot be spliced. -or- The rebar cannot be spliced with the provided line.
ArgumentNullException A non-optional argument was null
Remarks

If the provided linePlaneNormal is parallel with the bar plane normal the bounded line will be used to calculate the splice geometries where the bar will be splice.

Otherwise, the line will be extended to exceed the bounding box of the bar.

See Also
ArchiLabs

Stop fighting Revit automation.

Build repeatable BIM design and documentation workflows with scripts, data, and AI in one place, without wrestling brittle one-off automations.

Try ArchiLabs →