NewAreaLoad Method (CurveArray, Int32[], Int32[], XYZ, XYZ, XYZ, Boolean, AreaLoadType)
Creates a new unhosted area load with variable forces at the vertices within the project.

Namespace: Autodesk.Revit.Creation
Assembly: RevitAPI (in RevitAPI.dll) Version: 16.0.0.0 (16.0.0.0)

Syntax

C#
[ObsoleteAttribute("This method is obsolete in Revit 2016. Use AreaLoad.Create() method instead.")]
public AreaLoad NewAreaLoad(
	CurveArray curvesArr,
	int[] refPntIdxs,
	int[] ends,
	XYZ force0,
	XYZ force1,
	XYZ force2,
	bool isReaction,
	AreaLoadType symbol
)
Visual Basic
<ObsoleteAttribute("This method is obsolete in Revit 2016. Use AreaLoad.Create() method instead.")> _
Public Function NewAreaLoad ( _
	curvesArr As CurveArray, _
	refPntIdxs As Integer(), _
	ends As Integer(), _
	force0 As XYZ, _
	force1 As XYZ, _
	force2 As XYZ, _
	isReaction As Boolean, _
	symbol As AreaLoadType _
) As AreaLoad
Visual C++
[ObsoleteAttribute(L"This method is obsolete in Revit 2016. Use AreaLoad.Create() method instead.")]
public:
AreaLoad^ NewAreaLoad(
	CurveArray^ curvesArr, 
	array<int>^ refPntIdxs, 
	array<int>^ ends, 
	XYZ^ force0, 
	XYZ^ force1, 
	XYZ^ force2, 
	bool isReaction, 
	AreaLoadType^ symbol
)

Parameters

curvesArr
Type: Autodesk.Revit.DB..::..CurveArray
An array of curves that define the shape of the area load.
refPntIdxs
Type: array<System..::..Int32>[]()[][]
The indices of the curves in curvesArr that will be used to define the reference points for the load.
ends
Type: array<System..::..Int32>[]()[][]
Identifies which of the curve end points should be used for the reference points, for each member of refPntIdxs. The value should be 0 for the start point or 1 for the end point of the curve.
force0
Type: Autodesk.Revit.DB..::..XYZ
The 3d area force applied to the first reference point.
force1
Type: Autodesk.Revit.DB..::..XYZ
The 3d area force applied to the second reference point. Ignored if only one or two reference points are supplied.
force2
Type: Autodesk.Revit.DB..::..XYZ
The 3d area force applied to the third reference point. Ignored if only one or two reference points are supplied.
isReaction
Type: System..::..Boolean
Specifies if the load is a reaction load. The load cannot be modified if isReaction=True.
symbol
Type: Autodesk.Revit.DB.Structure..::..AreaLoadType
The symbol of the AreaLoad.

Return Value

If successful, NewAreaLoad returns an object for the newly created AreaLoad. nullNothingnullptra null reference (Nothing in Visual Basic) is returned if the operation fails.

Remarks

The size of the refPntIdxs and ends arrays must be the same, and a maximum of 3 values is permitted.

Exceptions

ExceptionCondition
Autodesk.Revit.Exceptions..::..InvalidOperationExceptionIf the product is not Revit Structure.
Autodesk.Revit.Exceptions..::..ArgumentExceptionThrown if the area load symbol does not exist in the given document.

See Also

M:Autodesk.Revit.Creation.Document.NewAreaLoad(Autodesk.Revit.DB.CurveArray,System.Int32[],System.Int32[],Autodesk.Revit.DB.XYZ,Autodesk.Revit.DB.XYZ,Autodesk.Revit.DB.XYZ,System.Boolean,Autodesk.Revit.DB.Structure.AreaLoadType)