Revit 2025 API

MechanicalUtilsConnectDuctPlaceholdersAtCross(Document, Connector, Connector, Connector, Connector) Method

Connects a group of placeholders that can intersect in a Cross connection.

Namespace: Autodesk.Revit.DB.Mechanical
Assembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)

Syntax

public static bool ConnectDuctPlaceholdersAtCross(
	Document document,
	Connector connector1,
	Connector connector2,
	Connector connector3,
	Connector connector4
)

Public Shared Function ConnectDuctPlaceholdersAtCross ( 
	document As Document,
	connector1 As Connector,
	connector2 As Connector,
	connector3 As Connector,
	connector4 As Connector
) As Boolean

public:
static bool ConnectDuctPlaceholdersAtCross(
	Document^ document, 
	Connector^ connector1, 
	Connector^ connector2, 
	Connector^ connector3, 
	Connector^ connector4
)

static member ConnectDuctPlaceholdersAtCross : 
        document : Document * 
        connector1 : Connector * 
        connector2 : Connector * 
        connector3 : Connector * 
        connector4 : Connector -> bool

Parameters

document Document: The document.
connector1 Connector: The end connector of the first placeholder.
connector2 Connector: The end connector of the second placeholder.
connector3 Connector: The end connector of the third placeholder.
connector4 Connector: The end connector of the fourth placeholder.

Return Value

Boolean
True if connection succeeds, false otherwise.

Exceptions

Exception	Condition
ArgumentException	The owner of connector is not duct placeholder. -or- The owners of connectors belong to different types of system. -or- The curves of connector1 and connector2 are not collinear or either the connecto1 or connector2 is not connector of curve end. -or- The curves of connector3 and connector4 are not collinear or either the connecto1 or connector2 is not connector of curve end.
ArgumentNullException	A non-optional argument was null

Remarks

The placeholders may or may not have physical connection. However:

The ends of four connectors should intersect at same point.
The first and second placeholders should be collinear each other.
The third and fourth placeholders should be collinear each other.
The third and fourth should have intersection with first or second placeholder.

If connection fails, the placeholders cannot be physically connected.

Reference

MechanicalUtils Class

ConnectDuctPlaceholdersAtCross Overload

Autodesk.Revit.DB.Mechanical Namespace

Send comments on this topic to Autodesk