Creates a new custom line load within the project.

Namespace: Autodesk.Revit.DB.Structure
Assembly: RevitAPI (in RevitAPI.dll) Version: 24.0.0.0 (24.0.0.0)
Since: 2024

Syntax

C#
`public static LineLoad Create( Document document, ElementId hostElemId, Curve curve, XYZ forceVector1, XYZ momentVector1, LineLoadType symbol )`

Visual Basic
`Public Shared Function Create ( _ document As Document, _ hostElemId As ElementId, _ curve As Curve, _ forceVector1 As XYZ, _ momentVector1 As XYZ, _ symbol As LineLoadType _ ) As LineLoad`

Visual C++
`public: static LineLoad^ Create( Document^ document, ElementId^ hostElemId, Curve^ curve, XYZ^ forceVector1, XYZ^ momentVector1, LineLoadType^ symbol )`

document: Type: Autodesk.Revit.DBDocument
Document to which new line load will be added.

hostElemId: Type: Autodesk.Revit.DBElementId
The analytical host element for the line Load.

symbol: Type: Autodesk.Revit.DB.StructureLineLoadType
The symbol of the LineLoad. Set a null reference (Nothing in Visual Basic) to use default type.

If successful, returns the newly created LineLoad, a null reference (Nothing in Visual Basic) otherwise.

Remarks

The curve must be bounded. The curve can be:

Exception	Condition
Autodesk.Revit.ExceptionsArgumentException	The element hostElemId does not exist in the document -or- hostElemId is not permitted for this type of load. -or- The provided curve is not supported. -or- The input curve is not bound.
Autodesk.Revit.ExceptionsArgumentNullException	A non-optional argument was null
Autodesk.Revit.ExceptionsArgumentsInconsistentException	Thrown when all force and moment vectors are equal zero.
Autodesk.Revit.ExceptionsInvalidOperationException	Thrown if type could not be set for newly created line load.