CreateDuctworkStiffener Method


Create family based stiffener on the specified fabrication ductwork.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 24.0.0.0 (24.0.0.0)
Since:  2024

Syntax

C#
public static FamilyInstance CreateDuctworkStiffener(
	Document document,
	ElementId familySymbolId,
	ElementId hostId,
	double distanceFromHostEnd
)
Visual Basic
Public Shared Function CreateDuctworkStiffener ( _
	document As Document, _
	familySymbolId As ElementId, _
	hostId As ElementId, _
	distanceFromHostEnd As Double _
) As FamilyInstance
Visual C++
public:
static FamilyInstance^ CreateDuctworkStiffener(
	Document^ document, 
	ElementId^ familySymbolId, 
	ElementId^ hostId, 
	double distanceFromHostEnd
)

Parameters

document
Type: Autodesk.Revit.DBDocument
The document.
familySymbolId
Type: Autodesk.Revit.DBElementId
The id of a stiffener FamilySymbol.
hostId
Type: Autodesk.Revit.DBElementId
The id of the host ductwork.
distanceFromHostEnd
Type: SystemDouble
The distance from the host primary end to place the hosted instance. Units are in feet (ft).

Return Value

The new stiffener family instance.

Exceptions

ExceptionCondition
Autodesk.Revit.ExceptionsArgumentException document is not a project document. -or- familySymbolId is not a valid Element identifier. -or- hostId is not a valid Element identifier. -or- Invalid familySymbolId for stiffeners. -or- Host is not a straight ductwork.
Autodesk.Revit.ExceptionsArgumentNullException A non-optional argument was null
Autodesk.Revit.ExceptionsArgumentOutOfRangeException The distance from host primary end is out of range.
Autodesk.Revit.ExceptionsInvalidOperationException The profiles of family symbol and host are mismatch.
Autodesk.Revit.ExceptionsModificationForbiddenException The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document is being loaded, or is in the midst of another sensitive process.
Autodesk.Revit.ExceptionsModificationOutsideTransactionException The document has no open transaction.
Autodesk.Revit.ExceptionsRegenerationFailedException Failed to create stiffener due to document regenerate error.

See Also