RadialArray.ArrayElementsWithoutAssociation
Method
Description:
Creates a new radial array from a set of elements based on an input rotation axis.
Creates a new radial array from a set of elements based on an input rotation axis.
Remarks:
The resulting elements will not be associated with an array element.
The resulting elements will not be associated with an array element.
Syntax
public static ICollection<ElementId> ArrayElementsWithoutAssociation(
Document aDoc,
View dBView,
ICollection<ElementId> ids,
int count,
Line axis,
double angle,
ArrayAnchorMember anchorMember
)
Parameters
Parameter | Type | Description |
---|---|---|
aDoc | Document | The document. |
dBView | View | The view. If it is a 2d view, translation vector must be in the view plane if elements include view-specific elements. If elements include view-specific elements, they must belong to this view. |
ids | ICollection | The set of elements to array. The position of the rotation axis is determined by the cumulative center of the elements' bounding boxes. |
count | Int32 | The number of array members to create. The accepted range is from 3 to 200 in a project document, and between 0 and 200 in a family document. |
axis | Line | The rotation axis. |
angle | Double | The angle in radians of the rotation. |
anchorMember | ArrayAnchorMember | Indicates if the translation vector specifies the location of the second member of the array, or the last member of the array. |
Return Value
Type | Description |
---|---|
ICollection | The elements created by the operation. |
Exceptions
Exception | Condition |
---|---|
ArgumentException | The given element id set is empty. -or- One or more elements in ids do not exist in the document. -or- One or more elements in ids is owned by different views and thus cannot be arrayed together. -or- One or more elements in ids is not arrayable. -or- count must be between 3 and 200 in project documents and between 0 and 200 in family documents. -or- The view is invalid for specific view elements array. -or- The rotation axis is invalid to array the elements. -or- Angle value must be not zero. |
ArgumentNullException | A non-optional argument was null |
ArgumentOutOfRangeException | A value passed for an enumeration argument is not a member of that enumeration |
InvalidOperationException | Failed to create the radial array. |