document.addNewRectangle()

document.addNewRectangle(boundingRectangle, roundness 
    [, bSuppressFill [, bSuppressStroke]])

参数

boundingRectangle 一个矩形，它指定要在其中添加新矩形的范围，其格式为 {left:value1,top:value2,right:value3,bottom:value4}。left 和 top 值指定左上角的位置（如 left:0,top:0 表示舞台的左上角），right 和 bottom 值指定右下角的位置。因此，矩形的宽度为 left 值和 right 值的差；矩形的高度为 top 值和 bottom 值的差。

也就是说，矩形的范围并非全部对应于"属性"检查器中显示的值。left 和 top 值分别对应于"属性"检查器中的 X 值和 Y 值。但是，right 和 bottom 值并不对应于"属性"检查器中的 W 和 H 值。例如，假设有一个矩形具有以下范围：

{left:10,top:10,right:50,bottom:100}

X = 10, Y = 10, W = 40, H = 90

roundness 一个介于 0 到 999 之间的整数值，它指定角要使用的圆度。该值指定为点的数目。值越大，则圆度越大。

bSuppressFill 一个布尔值，如果设置为 true，则此方法创建没有填充的形状。默认值为 false。此参数是可选的。

bSuppressStroke 一个布尔值，如果设置为 true，则此方法创建没有笔触的矩形。默认值为 false。此参数是可选的。

说明

方法；添加一个新的矩形或圆角矩形，并使其适应指定的范围。此方法与"矩形"工具执行的操作相同。此方法使用文档当前默认的笔触和填充属性，在当前的帧和图层上添加矩形。如果 bSuppressFill 参数设置为 true，则绘制没有填充的矩形。如果 bSuppressStroke 参数设置为 true，则绘制没有笔触的矩形。如果 bSuppressFill 和 bSuppressStroke 都设置为 true，则此方法不起作用。

示例

下面的示例在指定坐标范围内添加一个不带圆角的新矩形；它的高和宽都是 100 像素：

flash.getDocumentDOM().addNewRectangle({left:0,top:0,right:100,bottom:100},0);

下面的示例添加一个不带圆角和填充的新矩形；它的宽为 100 像素，高为 200 像素：

flash.getDocumentDOM().addNewRectangle({left:10,top:10,right:110,bottom:210},0, true);

下面的示例添加一个不带圆角和笔触的新矩形；它的宽为 200 像素，高为 100 像素：

flash.getDocumentDOM().addNewRectangle({left:20,top:20,right:220,bottom:120},0, false, true);

document.addNewRectangle()

可用性

用法

参数

返回

说明

示例