Adds a new swept blend into the family document, using a selected reference as the path.
Namespace: Autodesk.Revit.CreationAssembly: RevitAPI (in RevitAPI.dll) Version: 21.0.0.0 (21.1.1.109)
Syntax
C# |
---|
public SweptBlend NewSweptBlend( bool isSolid, Reference path, SweepProfile bottomProfile, SweepProfile topProfile ) |
Visual Basic |
---|
Public Function NewSweptBlend ( _ isSolid As Boolean, _ path As Reference, _ bottomProfile As SweepProfile, _ topProfile As SweepProfile _ ) As SweptBlend |
Visual C++ |
---|
public: SweptBlend^ NewSweptBlend( bool isSolid, Reference^ path, SweepProfile^ bottomProfile, SweepProfile^ topProfile ) |
Parameters
- isSolid
- Type: System..::..Boolean
Indicates if the swept blend is Solid or Void.
- path
- Type: Autodesk.Revit.DB..::..Reference
The path of the swept blend. The path might be a reference of single curve or edge obtained from existing geometry. Or the path can be a single sketched curve, and the curve is not required to reference existing geometry.
- bottomProfile
- Type: Autodesk.Revit.DB..::..SweepProfile
The bottom profile of the newly created Swept blend. It should consist of only one curve loop. the input profile must be in one plane.
- topProfile
- Type: Autodesk.Revit.DB..::..SweepProfile
The top profile of the newly created Swept blend. It should consist of only one curve loop. The profile must lie in the XY plane, and it will be transformed to the profile plane automatically.
Return Value
If creation was successful the new Swept blend is returned, otherwise an exception with failure information will be thrown.
Remarks
This method creates a swept blend in a family document. The swept blend will trace from bottom profile
to the top along the path. Revit will determine an appropriate default mapping for the vertices of the
two profiles. If the input profile is to be a cyclic profile (curve or ellipse) it must be split into at
least two segments, so that Revit can find vertices to use for mapping the swept blend.
Exceptions
Exception | Condition |
---|---|
Autodesk.Revit.Exceptions..::..ArgumentNullException | Thrown when the input arguments-path/bottomProfile/topProfile-are nullNothingnullptra null reference (Nothing in Visual Basic). |
Autodesk.Revit.Exceptions..::..ArgumentException | Thrown when the input argument-bottomProfile/topProfile-is a curve based profile and the profile is nullNothingnullptra null reference (Nothing in Visual Basic). |
Autodesk.Revit.Exceptions..::..ArgumentException | Thrown when the input argument-bottomProfile/topProfile-is a curve based profile and the profile contains nullNothingnullptra null reference (Nothing in Visual Basic) or more than one curve loops. |
Autodesk.Revit.Exceptions..::..ArgumentException | Thrown when the input argument-bottomProfile/topProfile-is a family symbol based profile and the family symbol profile is nullNothingnullptra null reference (Nothing in Visual Basic). |
Autodesk.Revit.Exceptions..::..InvalidOperationException | Thrown when the creation failed. |