•  

AddLoop Method

Creates an empty loop in a given face of the geometry being built. Other BRepBuilder methods are used to add co-edges to the loop.

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

Syntax

C#
public BRepBuilderGeometryId AddLoop(
	BRepBuilderGeometryId faceId
)
Visual Basic
Public Function AddLoop ( _
	faceId As BRepBuilderGeometryId _
) As BRepBuilderGeometryId
Visual C++
public:
BRepBuilderGeometryId^ AddLoop(
	BRepBuilderGeometryId^ faceId
)

Parameters

faceId
Type: Autodesk.Revit.DBBRepBuilderGeometryId
Id of the face to which the loop should be added. faceId was returned by a call to AddFace().

Return Value

An id that can be used to identify the loop while the BRepBuilder is actively building geometry (e.g., to add co-edges to the loop).

Exceptions

ExceptionCondition
Autodesk.Revit.ExceptionsArgumentException The supplied face id doesn't correspond to a face stored in this BRepBuilder object. -or- FinishFace() has already been called on faceId. -or- Please finish the previous loop by calling FinishLoop() before adding a new one.
Autodesk.Revit.ExceptionsArgumentNullException A non-optional argument was null
Autodesk.Revit.ExceptionsInvalidOperationException This BRepBuilder object isn't accepting new data, either because it has already been used to build geometry, or because of an error. Consult the State property of the BRepBuilder object for more details.

See Also