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

RebarShape.Create(Document, RebarShapeDefinition, RebarShapeMultiplanarDefinition, RebarStyle, StirrupTieAttachmentType, Int32, RebarHookOrientation, Int32, RebarHookOrientation, Int32, Double, Double, ElementId, ElementId)

Method

Description:
Create a new instance of a Rebar Shape, which defines the shape of a rebar.

Syntax

public static RebarShape Create(
	Document doc,
	RebarShapeDefinition definition,
	RebarShapeMultiplanarDefinition multiplanarDefinition,
	RebarStyle style,
	StirrupTieAttachmentType attachmentType,
	int startHookAngle,
	RebarHookOrientation startHookOrientation,
	int endHookAngle,
	RebarHookOrientation endHookOrientation,
	int higherEnd,
	double hookRotationAngleAtStart,
	double hookRotationAngleAtEnd,
	ElementId endTreatmentTypeIdAtStart,
	ElementId endTreatmentTypeIdAtEnd
)

Public Shared Function Create ( 
	doc As Document,
	definition As RebarShapeDefinition,
	multiplanarDefinition As RebarShapeMultiplanarDefinition,
	style As RebarStyle,
	attachmentType As StirrupTieAttachmentType,
	startHookAngle As Integer,
	startHookOrientation As RebarHookOrientation,
	endHookAngle As Integer,
	endHookOrientation As RebarHookOrientation,
	higherEnd As Integer,
	hookRotationAngleAtStart As Double,
	hookRotationAngleAtEnd As Double,
	endTreatmentTypeIdAtStart As ElementId,
	endTreatmentTypeIdAtEnd As ElementId
) As RebarShape

public:
static RebarShape^ Create(
	Document^ doc, 
	RebarShapeDefinition^ definition, 
	RebarShapeMultiplanarDefinition^ multiplanarDefinition, 
	RebarStyle style, 
	StirrupTieAttachmentType attachmentType, 
	int startHookAngle, 
	RebarHookOrientation startHookOrientation, 
	int endHookAngle, 
	RebarHookOrientation endHookOrientation, 
	int higherEnd, 
	double hookRotationAngleAtStart, 
	double hookRotationAngleAtEnd, 
	ElementId^ endTreatmentTypeIdAtStart, 
	ElementId^ endTreatmentTypeIdAtEnd
)

static member Create : 
        doc : Document * 
        definition : RebarShapeDefinition * 
        multiplanarDefinition : RebarShapeMultiplanarDefinition * 
        style : RebarStyle * 
        attachmentType : StirrupTieAttachmentType * 
        startHookAngle : int * 
        startHookOrientation : RebarHookOrientation * 
        endHookAngle : int * 
        endHookOrientation : RebarHookOrientation * 
        higherEnd : int * 
        hookRotationAngleAtStart : float * 
        hookRotationAngleAtEnd : float * 
        endTreatmentTypeIdAtStart : ElementId * 
        endTreatmentTypeIdAtEnd : ElementId -> RebarShape

Parameters

Parameter	Type	Description
doc	Document	A document to contain the RebarShape.
definition	RebarShapeDefinition	The definition of the rebar shape, as a set of curves in a plane driven by parameters.
multiplanarDefinition	RebarShapeMultiplanarDefinition	If not <span class="keyword"><span data-languagespecifictext="cpp=nullptr\|vb=Nothing\|nu=null" id="LSTD9D6FBE5_1"></span></span>, the created RebarShape will be a 3D shape. The shape is built out of the planar RebarShapeDefinition, with additional out-of-plane segments defined by the RebarShapeMultiplanarDefinition object. Not supported in conjunction with RebarShapeDefinitionByArc of type Spiral or LappedCircle.
style	RebarStyle	Whether the shape is to be used as a standard bar or a stirrup/tie.
attachmentType	StirrupTieAttachmentType	When the style is stirrup/tie, specify whether it will attach to the interior of cover (cover is measured to the stirrups), or to the exterior of cover (cover is measured to the standard bars). Ignored when the style is Standard.
startHookAngle	Int32	The start hook angle, expressed as an integral number of degrees. If 0, the shape will have no start hook. Common values are 0, 90, 135, and 180.
startHookOrientation	RebarHookOrientation	The orientation of the start hook. Ignored when startHookAngle is 0.
endHookAngle	Int32	The end hook angle, expressed as an integral number of degrees. If 0, the shape will have no end hook. Common values are 0, 90, 135, and 180.
endHookOrientation	RebarHookOrientation	The orientation of the end hook. Ignored when endHookAngle is 0.
higherEnd	Int32	When the rebar crosses itself, one end will be "lifted" to avoid self-intersection. Specify which end should be lifted: 0 for start, 1 for end.
hookRotationAngleAtStart	Double	The out of plane hook rotation angle at the start of the bar.
hookRotationAngleAtEnd	Double	The out of plane hook rotation angle at the end of the bar.
endTreatmentTypeIdAtStart	ElementId	The end treatment type id at the start of the bar.
endTreatmentTypeIdAtEnd	ElementId	The end treatment type id at the end of the bar.

Return Value

Type	Description
RebarShape	A new RebarShape instance.

Exceptions

Exception	Condition
ArgumentException	definition is linked to a Document other than doc. -or- A multiplanar definition is specified when the given RebarShapeDefinition does not support it. The following RebarShapeDefinitions do not support multiplanar: a simple line; spiral; lapped circle. -or- The DepthParamId property of multiplanarDefinition is invalid or has not been added to definition. -or- the parameter endTreatmentTypeIdAtStart is not an EndTreatmentType element. -or- the parameter endTreatmentTypeIdAtEnd is not an EndTreatmentType element.
ArgumentNullException	A non-optional argument was null
ArgumentOutOfRangeException	startHookAngle must be at least 0 and no more than 180. -or- endHookAngle must be at least 0 and no more than 180. -or- higherEnd must be 0 or 1. -or- A value passed for an enumeration argument is not a member of that enumeration