Namespace: Autodesk.Revit.DB.Structure Class: Rebar

Rebar.CreateFreeForm(Document, RebarBarType, Element, IList<CurveLoop>, RebarFreeFormValidationResult)

Method

Description:
Creates a free form rebar that will be unconstrained. Constraints can't be added later to this rebar.

Remarks:
The created rebar will have curves.Count bars. The layout will be Single if curves.Count is 1, otherwise will be Fixed Number and will not be changeable. Setting a new list of curves will only change the number of bars in set.

This function can fail due to following reasons:

The array of CurveLoops is empty.
At least one CurveLoop is empty.
At least one CurveLoop contains an unbounded curve.
A rebar constructed from curves can't be bent according to the bending radius.

Syntax

public static Rebar CreateFreeForm(
	Document doc,
	RebarBarType barType,
	Element host,
	IList<CurveLoop> curves,
	out RebarFreeFormValidationResult error
)

Public Shared Function CreateFreeForm ( 
	doc As Document,
	barType As RebarBarType,
	host As Element,
	curves As IList(Of CurveLoop),
	<OutAttribute> ByRef error As RebarFreeFormValidationResult
) As Rebar

public:
static Rebar^ CreateFreeForm(
	Document^ doc, 
	RebarBarType^ barType, 
	Element^ host, 
	IList<CurveLoop^>^ curves, 
	[OutAttribute] RebarFreeFormValidationResult% error
)

static member CreateFreeForm : 
        doc : Document * 
        barType : RebarBarType * 
        host : Element * 
        curves : IList<CurveLoop> * 
        error : RebarFreeFormValidationResult byref -> Rebar

Parameters

Parameter	Type	Description
doc	Document	A document.
barType	RebarBarType	A RebarBarType element that defines bar diameter, bend radius and material of the rebar.
host	Element	The element to which the rebar belongs. The element must support rebar hosting.
curves	IList	Each curve loop represents a bar in the set.
error	RebarFreeFormValidationResult	Will be Success(0) if everything is ok, otherwise the failure reason.

Return Value

Type	Description
Rebar	The newly created free form Rebar Instance.

Exceptions

Exception	Condition
ArgumentException	host is not a valid rebar host.
ArgumentNullException	A non-optional argument was null
ArgumentOutOfRangeException	A value passed for an enumeration argument is not a member of that enumeration