M

CableTray.Create

Description:
Creates a new instance of cable tray.

Remarks:
This method will regenerate the document.

public static CableTray Create(
	Document document,
	ElementId cabletrayType,
	XYZ startPoint,
	XYZ endPoint,
	ElementId levelId
)

Public Shared Function Create ( _
	document As Document, _
	cabletrayType As ElementId, _
	startPoint As XYZ, _
	endPoint As XYZ, _
	levelId As ElementId _
) As CableTray

public:
static CableTray^ Create(
	Document^ document, 
	ElementId^ cabletrayType, 
	XYZ^ startPoint, 
	XYZ^ endPoint, 
	ElementId^ levelId
)

Autodesk.Revit.DB.Document

document

The document.
Autodesk.Revit.DB.ElementId

cabletrayType

The cable tray type. This must be a cable tray type accepted by isValidCableTrayType(). If the input cable tray type is InvalidElementId, the default cable tray type from the document will be used.
Autodesk.Revit.DB.XYZ

startPoint

The start point of the cable tray location line.
Autodesk.Revit.DB.XYZ

endPoint

The end point of the cable tray location line.
Autodesk.Revit.DB.ElementId

levelId

The element id of the level which this cable tray based. If the input level id is invalidElementId = -1, the nearest level will be used.

Return Value CableTray The newly created cable tray.

Autodesk.Revit.Exceptions.ArgumentException

This cable tray type is invalid. -or- This level id is invalid. -or- The points of startPoint and endPoint are too close: for MEPCurve, the minimum length is 1/10 inch.
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was NULL
Autodesk.Revit.Exceptions.DisabledDisciplineException

None of the following disciplines is enabled: Mechanical Electrical Piping.
Autodesk.Revit.Exceptions.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).
Autodesk.Revit.Exceptions.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.
Autodesk.Revit.Exceptions.ModificationOutsideTransactionException

The document has no open transaction.