CreateHanger Method (Document, FabricationServiceButton, ElementId, Connector, Double, Boolean)


Creates a hanger on the fabrication part.

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

Syntax

C#
public static FabricationPart CreateHanger(
	Document document,
	FabricationServiceButton button,
	ElementId hostId,
	Connector hostConnector,
	double distance,
	bool attachToStructure
)
Visual Basic
Public Shared Function CreateHanger ( _
	document As Document, _
	button As FabricationServiceButton, _
	hostId As ElementId, _
	hostConnector As Connector, _
	distance As Double, _
	attachToStructure As Boolean _
) As FabricationPart
Visual C++
public:
static FabricationPart^ CreateHanger(
	Document^ document, 
	FabricationServiceButton^ button, 
	ElementId^ hostId, 
	Connector^ hostConnector, 
	double distance, 
	bool attachToStructure
)

Parameters

document
Type: Autodesk.Revit.DBDocument
The document.
button
Type: Autodesk.Revit.DBFabricationServiceButton
The fabrication service button to use. It finds the matching condition automatically if the button has multiple condition.
hostId
Type: Autodesk.Revit.DBElementId
The host part id. The host should be one horizontal straight part.
hostConnector
Type: Autodesk.Revit.DBConnector
The connector of the host.
distance
Type: SystemDouble
The distance from the input connector of the host part. Units are in feet (ft).
attachToStructure
Type: SystemBoolean
Attach to the nearest structural element. The structural element might be one of Floor/Roof/Stair/Structure Framing.

Return Value

The newly-created fabrication hanger.

Exceptions

ExceptionCondition
Autodesk.Revit.ExceptionsArgumentException Hangers may only be placed on straight horizontal fabrication segments and some kind of fittings. -or- Invalid fabrication service button. -or- The distance is out of range.
Autodesk.Revit.ExceptionsArgumentNullException A non-optional argument was null
Autodesk.Revit.ExceptionsInvalidOperationException cannot place hanger on the host.

See Also

ArchiLabs

Stop fighting Revit automation.

Build repeatable BIM design and documentation workflows with scripts, data, and AI in one place, without wrestling brittle one-off automations.

Try ArchiLabs →