M

PointLoad.Create

Description:
Creates a new custom hosted point load within the project using data at point.

Overloads (2):

Create(Document,ElementId,AnalyticalElementSelector,XYZ,XYZ,PointLoadType)

Create(Document,ElementId,XYZ,XYZ,XYZ,PointLoadType)

public static PointLoad Create(
	Document document,
	ElementId hostElemId,
	XYZ point,
	XYZ forceVector,
	XYZ momentVector,
	PointLoadType symbol
)

Public Shared Function Create ( _
	document As Document, _
	hostElemId As ElementId, _
	point As XYZ, _
	forceVector As XYZ, _
	momentVector As XYZ, _
	symbol As PointLoadType _
) As PointLoad

public:
static PointLoad^ Create(
	Document^ document, 
	ElementId^ hostElemId, 
	XYZ^ point, 
	XYZ^ forceVector, 
	XYZ^ momentVector, 
	PointLoadType^ symbol
)

Autodesk.Revit.DB.Document

document

Document to which new point load will be added.
Autodesk.Revit.DB.ElementId

hostElemId

The AnalyticalElement host element for the point Load.
Autodesk.Revit.DB.XYZ

point

The position of point load, measured in decimal feet.
Autodesk.Revit.DB.XYZ

forceVector

The applied 3d force vector.
Autodesk.Revit.DB.XYZ

momentVector

The applied 3d moment vector.
Autodesk.Revit.DB.Structure.PointLoadType

symbol

The symbol of the PointLoad. Set nulla null reference (Nothing in Visual Basic) to use default type.

Return Value nullNothingnullptr If successful, returns the newly created PointLoad, null Nothing nullptr a null reference ( Nothing in Visual Basic) otherwise.

Document document = commandData.Application.ActiveUIDocument.Document;
UIDocument activeDoc = commandData.Application.ActiveUIDocument;

//select object for adding a point load
Reference eRef = activeDoc.Selection.PickObject(ObjectType.Element, "Please select the analytical element");
ElementId selectedElementId = null;
if (eRef != null && eRef.ElementId != ElementId.InvalidElementId)
   selectedElementId = eRef.ElementId;

XYZ location = activeDoc.Selection.PickPoint("Point Load location");

using (Transaction transaction = new Transaction(document, "Create custom PointLoad"))
{
   transaction.Start();
   PointLoad pointLoad = null;

   if (PointLoad.IsPointInsideHostBoundaries(document, selectedElementId, location))
      pointLoad = PointLoad.Create(document, selectedElementId, location, new XYZ(1, 0, 0), new XYZ(1, 0, 0), null);

   transaction.Commit();
}

Autodesk.Revit.Exceptions.ArgumentException

hostElemId is not permitted for this type of load. -or- Thrown when work plane is not valid.
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was null
Autodesk.Revit.Exceptions.ArgumentsInconsistentException

Thrown when force and moment vectors are equal zero.
Autodesk.Revit.Exceptions.InvalidOperationException

Thrown if type could not be set for newly created point load.