ArrayRectangular 方法

创建对象的二维或三维矩形阵列。

参阅 | 示例

语法

RetVal = object.ArrayRectangular (NumberOfRows, NumberOfColumns, NumberOfLevels, DistBetweenRows, DistBetweenColumns, DistBetweenLevels)

Object

所有图形对象
使用该方法的对象。

NumberOfRows

Integer[整数]; 仅用于输入
矩形阵列的行数。该值必须为正数。如果该值为1,则 NumberOfColumns 必须大于1。

NumberOfColumns

Integer[整数]; 仅用于输入
矩形阵列的列数。该值必须为正数。如果该值为1,则 NumberOfRows 必须大于1。

NumberOfLevels

Integer[整数]; 仅用于输入
三维阵列的层数。

DistBetweenRows

Double[双精度]; 仅用于输入
行间的距离。如果该距离为正数,行是从基础图元向上添加。如果该距离为负数,行是向下添加。

DistBetweenColumns

Double[双精度]; 仅用于输入
列间的距离。如果该距离为正数,列是从基础图元向右添加。如果该距离为负数,列是向左添加。

DistBetweenLevels

Double[双精度]; 仅用于输入
层间的距离。如果该距离为正数,层是从基础图元向正方向添加。如果该距离为负数,层向负方向添加。

RetVal

Variant Array [变体数组](对象数组)
新创建对象的数组。

说明

对于二维阵列,可指定 NumberOfRows、 NumberOfColumns、DistBetweenRow 和 DistBetweenColumns。对于创建三维阵列,可再增加指定 NumberOfLevels 和 DistBetweenLevels 。

矩形阵列的构成是通过按一定数量和方式复制指定对象。如果只定义了一行,则需要指定多于一列的阵列,反之亦然。

选定的对象被假设在左下角,阵列是向上和向右生成的。如果行间距为负数,则行向下增加。如果列间距为负数,则列向左添加。

AutoCAD 构造矩形阵列是通过当前捕捉旋转角度所定义的基线进行的。该角度默认值为 0,所以矩形阵列的行和列相对于图形的 XY 转是正交的。用户可以通过设置捕捉旋转角度为非零值来更改该角度以创建带旋转角度的阵列。要修改该角度,可使用 SnapRotationAngle 属性。

按 NumberOfRows = 4,
NumberOfColumns = 3, DistBetweenRows = a,
DistBetweenColumns = b 进行矩形阵列。
基础图元用蓝色表示。

注意 当同时遍历集合时不能执行该方法。在遍历过程中将打开一个只读操作的工作空间,而该方法试图执行可读写操作。必须在完成遍历后才调用该方法。

AttributeReference: 不能在 AttributeReference 对象上使用该方法。AttributeReference 对象继承了该方法是因为它是图形对象,然而,它不能操作属性参照。