PlaceFittingAsCutIn Method


Places the fitting on the straight part by cut in, use the fitting's focal point as the insertion position.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 17.0.0.0 (17.0.484.0)
Since: 2017

Syntax

C#
public static bool PlaceFittingAsCutIn(
	Document doc,
	ElementId straightId,
	ElementId fittingId,
	XYZ position,
	Connector fittingConn,
	double axisRotation
)
Visual Basic
Public Shared Function PlaceFittingAsCutIn ( _
	doc As Document, _
	straightId As ElementId, _
	fittingId As ElementId, _
	position As XYZ, _
	fittingConn As Connector, _
	axisRotation As Double _
) As Boolean
Visual C++
public:
static bool PlaceFittingAsCutIn(
	Document^ doc, 
	ElementId^ straightId, 
	ElementId^ fittingId, 
	XYZ^ position, 
	Connector^ fittingConn, 
	double axisRotation
)

Parameters

doc
Type: Autodesk.Revit.DB Document
The document.
straightId
Type: Autodesk.Revit.DB ElementId
Id of the straight to be cut in.
fittingId
Type: Autodesk.Revit.DB ElementId
Id of the fitting to cut in.
position
Type: Autodesk.Revit.DB XYZ
The position to cut in the straight.
fittingConn
Type: Autodesk.Revit.DB Connector
The connector of the fitting to align with the primary connector of the straight part.
axisRotation
Type: System Double
Rotation around the direction of connection - angle between width vectors in radians.

Return Value

True if cuts in successfully.

Exceptions

Exception Condition
Autodesk.Revit.Exceptions ArgumentException For rectangular and oval parts the axis rotation must be a multiple of PI/2. -or- fittingConn is not a connector of the fitting. -or- fittingConn is not valid, it is not within a pair connector for cutting in.
Autodesk.Revit.Exceptions ArgumentNullException A non-optional argument was NULL
Autodesk.Revit.Exceptions InvalidOperationException Failed to align fitting to the straight to cut in. -or- There is no enough room in the run for cut in.

See Also