PlaceOnHost Method (ElementId, Connector, Double, Double)


Places the part on the specified host.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 18.0.0.0 (18.0.0.420)
Since: 2018

Syntax

C#
public void PlaceOnHost(
	ElementId hostId,
	Connector hostConnector,
	double distance,
	double axisRotation
)
Visual Basic
Public Sub PlaceOnHost ( _
	hostId As ElementId, _
	hostConnector As Connector, _
	distance As Double, _
	axisRotation As Double _
)
Visual C++
public:
void PlaceOnHost(
	ElementId^ hostId, 
	Connector^ hostConnector, 
	double distance, 
	double axisRotation
)

Parameters

hostId
Type: Autodesk.Revit.DB ElementId
Id of the host fabrication part.
hostConnector
Type: Autodesk.Revit.DB Connector
The connector of the host.
distance
Type: System Double
The distance from the connector to place the hosted part. Units are in feet (ft).
axisRotation
Type: System Double
The axis rotation in radians.

Remarks

The document must be regenerated before the fabrication part can be used. Check ValidationStatus after regeneration to see if the part is valid for fabrication.

Exceptions

Exception Condition
Autodesk.Revit.Exceptions ArgumentException Invalid fabrication part host. The host should be a straight fabrication part. -or- Invalid connector of fabrication part host. -or- The distance is out of range. -or- For rectangular and oval parts the axis rotation must be a multiple of PI/2.
Autodesk.Revit.Exceptions ArgumentNullException A non-optional argument was NULL

See Also