ComponentRepeater.RepeatElements Method

ComponentRepeaterRepeatElements Method

Repeats a set of adaptive component hosted on one or more repeating references.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)
Syntax
public static IList<ComponentRepeater> RepeatElements(
	Document document,
	ICollection<ElementId> elementIds
)
Public Shared Function RepeatElements ( 
	document As Document,
	elementIds As ICollection(Of ElementId)
) As IList(Of ComponentRepeater)
public:
static IList<ComponentRepeater^>^ RepeatElements(
	Document^ document, 
	ICollection<ElementId^>^ elementIds
)
static member RepeatElements : 
        document : Document * 
        elementIds : ICollection<ElementId> -> IList<ComponentRepeater>

Parameters

document  Document
The document that contains the elements.
elementIds  ICollectionElementId
The set of adaptive components used as an input pattern for the repeating operation.

Return Value

IListComponentRepeater
One or more component repeater objects representing the result pattern of the repeating operation.
Exceptions
ExceptionCondition
ArgumentException The document does not allow creation of a component repeater. -or- The given element id set is empty. -or- One or more elements in elementIds do not exist in the document. -or- Not all given elements can be repeated. All elements must be adaptive family instances, have no shape handles, and have at least one placement point hosted on a 1D or 2D repeating reference. The remaining placement points must be either unhosted or hosted on another repeating reference.
ArgumentNullException A non-optional argument was null
ModificationForbiddenException The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document is being loaded, or is in the midst of another sensitive process.
ModificationOutsideTransactionException The document has no open transaction.
Remarks
All elements must be adaptive family instances and have no shape handles. At least one placement point must be hosted on a 1D or 2D repeating reference. All other placement points can be hosted on a 0D, 1D or 2D repeating reference, or must be unhosted. Use CanElementBeRepeated(Document, ElementId) to test whether an element meets these conditions.
See Also

M:Autodesk.Revit.DB.ComponentRepeater.RepeatElements(Autodesk.Revit.DB.Document,System.Collections.Generic.ICollection{Autodesk.Revit.DB.ElementId})