Namespace: Autodesk.Revit.DB.Mechanical Class: MechanicalUtils

MechanicalUtils.ConnectDuctPlaceholdersAtCross(Document, Connector, Connector, Connector, Connector)

Method

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

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.

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

Parameter	Type	Description
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

Type	Description
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