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
)

Parameters

document
Type: Autodesk.Revit.DB..::..Document
Document to which new line load will be added.
hostElemId
Type: Autodesk.Revit.DB..::..ElementId
The analytical host element for the line Load.
curve
Type: Autodesk.Revit.DB..::..Curve
Curve of the line load.
forceVector1
Type: Autodesk.Revit.DB..::..XYZ
The applied 3d force vector.
momentVector1
Type: Autodesk.Revit.DB..::..XYZ
The applied 3d moment vector.
symbol
Type: Autodesk.Revit.DB.Structure..::..LineLoadType
The symbol of the LineLoad. Set nullNothingnullptra null reference (Nothing in Visual Basic) to use default type.

Return Value

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

Remarks

The curve must be bounded. The curve can be:
  • Line
  • Arc
  • Ellipse

Exceptions

ExceptionCondition
Autodesk.Revit.Exceptions..::..ArgumentException 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.Exceptions..::..ArgumentNullException A non-optional argument was null
Autodesk.Revit.Exceptions..::..ArgumentsInconsistentException Thrown when all force and moment vectors are equal zero.
Autodesk.Revit.Exceptions..::..InvalidOperationException Thrown if type could not be set for newly created line load.

See Also