StructuralConnectionHandlerCreate(Document, IListElementId, ElementId) Method |
Creates a new instance of a Structural Connection Handler, which defines the connection between given elements.
Namespace: Autodesk.Revit.DB.StructureAssembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)
Syntaxpublic static StructuralConnectionHandler Create(
Document document,
IList<ElementId> idsToConnect,
ElementId typeId
)
Public Shared Function Create (
document As Document,
idsToConnect As IList(Of ElementId),
typeId As ElementId
) As StructuralConnectionHandler
public:
static StructuralConnectionHandler^ Create(
Document^ document,
IList<ElementId^>^ idsToConnect,
ElementId^ typeId
)
static member Create :
document : Document *
idsToConnect : IList<ElementId> *
typeId : ElementId -> StructuralConnectionHandler
Parameters
- document Document
-
The Revit document.
- idsToConnect IListElementId
-
List of element ids of connected elements.
- typeId ElementId
-
The type of Structural Connection Handler.
Return Value
StructuralConnectionHandler
The newly created connection.
ExceptionsException | Condition |
---|
ArgumentException |
It verifies that we have at least one element id in the list.
-or-
The type typeId is not a valid StructuralConnectionHandlerType.
-or-
Missing detailed structural connection service implementation.
|
ArgumentNullException |
A non-optional argument was null
|
InvalidOperationException |
The document is in failure mode: an operation has failed,
and Revit requires the user to either cancel the operation
or fix the problem (usually by deleting certain elements).
|
ModificationForbiddenException |
The document is in failure mode: an operation has failed,
and Revit requires the user to either cancel the operation
or fix the problem (usually by deleting certain elements).
-or-
The document is being loaded, or is in the midst of another
sensitive process.
|
ModificationOutsideTransactionException |
The document has no open transaction.
|
Remarks
Elements should be of the following structural categories: framings (OST_StructuralFraming), columns (OST_StructuralColumns), walls (OST_Walls), floors (OST_Floors) or foundations (OST_StructuralFoundations).
The first of given elements is set as primary one.
See Also