M

RebarSpliceUtils.SpliceRebar

Description:
Splice a rebar with a line.

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.

Overloads (3):

SpliceRebar

SpliceRebar(Document,ElementId,RebarSpliceOptions,IList[RebarSpliceGeometry])

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

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

public static IList<ElementId> SpliceRebar(
	Document document,
	ElementId rebarIdToSplice,
	RebarSpliceOptions spliceOptions,
	Line line,
	XYZ linePlaneNormal
)

Public Shared Function SpliceRebar ( 
	document As Document,
	rebarIdToSplice As ElementId,
	spliceOptions As RebarSpliceOptions,
	line As Line,
	linePlaneNormal As XYZ
) As IList(Of ElementId)

public:
static IList<ElementId^>^ SpliceRebar(
	Document^ document, 
	ElementId^ rebarIdToSplice, 
	RebarSpliceOptions^ spliceOptions, 
	Line^ line, 
	XYZ^ linePlaneNormal
)

static member SpliceRebar : 
        document : Document * 
        rebarIdToSplice : ElementId * 
        spliceOptions : RebarSpliceOptions * 
        line : Line * 
        linePlaneNormal : XYZ -> IList<ElementId>

Document

document

The document
ElementId

rebarIdToSplice

Rebar id to splice.
RebarSpliceOptions

spliceOptions

The rebar splice options.
Line

line

The line used for splice.
XYZ

linePlaneNormal

The normal of the plane of the line.

Return Value IList<ElementId> Returns the ids of the rebars that are considered to be spliced.

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