如何利用Revit API提供的阵列方法

Revit API提供的阵列方法可以对一 个或者多个元素创建线型的或者是圆弧型的阵列。例如，可以选择墙上的一扇门或者一扇窗，阵列出多个门或窗的实体。

下面列出阵列方法及其描述。

方法	描述
static LinearArray Create(Document aDoc, View dBView, ElementId id, int count, XYZ translationToAnchorMember, ArrayAnchorMember anchorMember);	从传入的元素中创边一个线型阵列
static LinearArray Create(Document aDoc, View dBView, ICollection<ElementId> ids, int count, XYZ translationToAnchorMember, ArrayAnchorMember anchorMember);	从传入的元素集中创建一个线型阵列
static RadialArray Create(Document aDoc, View dBView, ElementId id, int count, Line axis, double angle, ArrayAnchorMember anchorMember);	从传入的元素中创建一个基于旋转轴的圆弧型阵列
static RadialArray Create(Document aDoc, View dBView, ICollection<ElementId> ids, int count, Line axis, double angle, ArrayAnchorMember anchorMember);	从传入的元素集中创建一个基于旋转轴的圆弧型阵列

阵列有两种类型:线型阵列和圆弧型阵列。

线型阵列是在Revit中呈线型状的阵列; 圆弧型阵列则呈圆弧型。

以下代码用线型阵列了一堵墙，阵列数为3,其阵列方向为Y向量,到第二个阵列元素的平移量为10英尺

public void ArraryElements(Document projectDoc)
        {
            //ElementId 313057 is a wall instance id
            Wall wall = projectDoc.GetElement(new ElementId(313057)) as Wall;
            using (Transaction tran = new Transaction(projectDoc, "LinearArray the wall."))
            {
                tran.Start();
                XYZ translation = new XYZ(0, 10, 0);
                LinearArray.Create(projectDoc, projectDoc.ActiveView, wall.Id, 3, translation,
  ArrayAnchorMember.Second);
                tran.Commit();
            }
        }

结果视图：

创建阵列时不仅创建了模型元素，而且同时创建了对应的阵列组。
阵列里面每一个实体都是阵列组合的一个成员。

如上图所示，阵列组的成员为原来的墙以及阵列创建的另外2堵墙。如果需要创建几个相同组件的实体并同时操作它们，使用阵列方法是很方便的。

使用阵列方法需要注意以下几个方面：
① 阵列数是有限定范围的， 线型阵列范围是2到200,圆弧型阵列是3到200。
② 当做线型和圆弧型阵列操作时，其他元素依赖于这个将被阵列的元素也会跟着一起阵列。
③ 有的元素不能被阵列:如section，因为它们不能被组合。
④ 大多数Annotation symbols是不支持阵列的。

LinearArray 和 RadialArray 也提供了 ArrayElementWithoutAssociate 和 ArrayElementsWithoutAssociate来阵列一个或者多个元素，这些元素是没有被组合和关联起来的，这些方法的使用类似于阵列的创建方法。

=========【更多高级应用请关注公众号】========

==================================