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: 24.0.0.0 (24.0.0.0)
Since:  2017

Syntax

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

Parameters

document
Type: Autodesk.Revit.DB..::..Document
The document.
straightId
Type: Autodesk.Revit.DB..::..ElementId
Identifier of the straight to be cut in.
fittingId
Type: Autodesk.Revit.DB..::..ElementId
Identifier of the fitting to cut in.
position
Type: Autodesk.Revit.DB..::..XYZ
The position to cut in the straight.
fittingConnector
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 successful.

Exceptions

ExceptionCondition
Autodesk.Revit.Exceptions..::..ArgumentException For rectangular and oval parts the axis rotation must be a multiple of PI/2. -or- The fitting connector is not a connector of the fitting. -or- The fitting connector 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