This method creates a constraint for a given RebarConstrainedHandle.
Using this method for Shape-Driven Rebar will throw exception. If you need a new RebarConstraint for a handle of a Shape-Driven Rebar, you can obtain a list of possible constraints using one of the RebarConstraintsManager.GetConstraintCandidatesForHandle functions, choose the desired one, and set it as preferred.
Namespace: Autodesk.Revit.DB.Structure
Assembly: RevitAPI (in RevitAPI.dll) Version: 26.4.0.0 (26.4.0.0)
Syntax
C#
public static RebarConstraint Create( RebarConstrainedHandle handle, IList<Reference> targetReferences, bool isConstraintToCover, double offsetValue )
Parameters
- handle RebarConstrainedHandle
- The handle of the rebar that will be constrained.
- targetReferences IList<Reference>
- The references to which the rebar handle will be constrained. This collection must contain one or more references to faces of elements that can host rebar.
- isConstraintToCover Boolean
- If true the RebarConstraintType will be set to ToCover, otherwise RebarConstraintType will be set to FixedDistanceToHostFace.
- offsetValue Double
- The distance from references to the rebar handle.
Return Value
RebarConstraintReturns the newly created RebarConstraint.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | Constrained rebar isn't a free form rebar element. -or- handle is no longer valid. -or- targetReferences is empty. -or- targetReferences do not represent faces from structurals that can host rebar. |
| ArgumentNullException | A non-optional argument was null |