•  

Create Method (Document, View, ElementId, Int32, XYZ, ArrayAnchorMember)

Creates a new linear array element from a single element.

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

Syntax

C#
public static LinearArray Create(
	Document aDoc,
	View dBView,
	ElementId id,
	int count,
	XYZ translationToAnchorMember,
	ArrayAnchorMember anchorMember
)
Visual Basic
Public Shared Function Create ( _
	aDoc As Document, _
	dBView As View, _
	id As ElementId, _
	count As Integer, _
	translationToAnchorMember As XYZ, _
	anchorMember As ArrayAnchorMember _
) As LinearArray
Visual C++
public:
static LinearArray^ Create(
	Document^ aDoc, 
	View^ dBView, 
	ElementId^ id, 
	int count, 
	XYZ^ translationToAnchorMember, 
	ArrayAnchorMember anchorMember
)

Parameters

aDoc
Type: Autodesk.Revit.DBDocument
The document.
dBView
Type: Autodesk.Revit.DBView
The view. If it is a 2d view, translation vector must be in the view plane if the element is a view-specific element.
id
Type: Autodesk.Revit.DBElementId
The element to array.
count
Type: SystemInt32
The number of array members to create including the initial element grouping. Must between 2 and 200.
translationToAnchorMember
Type: Autodesk.Revit.DBXYZ
The translation vector for the array.
anchorMember
Type: Autodesk.Revit.DBArrayAnchorMember
Indicates if the translation vector specifies the location of the second member of the array, or the last member of the array.

Return Value

The new linear array element.

Exceptions

ExceptionCondition
Autodesk.Revit.ExceptionsArgumentException The element id does not exist in the document -or- id is not arrayable. -or- count must be between 2 and 200. -or- The view is invalid for specific view elements array. -or- The translation point vector is invalid to array the element.
Autodesk.Revit.ExceptionsArgumentNullException A non-optional argument was null
Autodesk.Revit.ExceptionsArgumentOutOfRangeException A value passed for an enumeration argument is not a member of that enumeration
Autodesk.Revit.ExceptionsInvalidOperationException Failed to create the linear array.

See Also