MACROMEDIA FLASH 8-EXTENDING FLASH, Manual

Page: 76 / 554

76 Objects
Parameters
boundingRectangle
A rectangle that specifies the bounds within which the new rectangle
is added, in the format
{left:value1,top:value2,right:value3,bottom:value4}
. The
left
and
top
values specify the location of the upper-left corner (e.g.,
left:0,top:0
represents the upper-left of the Stage), and the
right
and
bottom
values specify location of
the lower-right corner. Therefore, the width of the rectangle is the difference in value between
left
and
right
, and the height of the rectangle is the difference in value between
top
and
bottom
.
In other words, the rectangle bounds do not all correspond to the values shown in the
Property inspector. The
left
and
top
values correspond to the X and Y values in the Property
inspector, respectively. However, the
right
and
bottom
values don’t correspond to the W and
H values in the Property inspector. For example, consider a rectangle with the following
bounds:
{left:10,top:10,right:50,bottom:100}
This rectangle would display the following values in the Property inspector:
X = 10, Y = 10, W = 40, H = 90
roundness
An integer value from 0 to 999 that specifies the roundness to use for the
corners. The value is specified as number of points. The greater the value, the greater the
roundness.
bSuppressFill
A Boolean value that, if set to
true
, causes the method to create the shape
without a fill. The default value is
false
. This parameter is optional.
bSuppressStroke
A Boolean value that, if set to
true
, causes the method to create the
rectangle without a stroke . The default value is
false
. This parameter is optional.
Returns
Nothing.
Description
Method; adds a new rectangle or rounded rectangle, fitting it into the specified bounds. This
method performs the same operation as the rectangle tool. The method uses the document’s
current default stroke and fill attributes and adds the rectangle on the current frame and layer.
If the
bSuppressFill
parameter is set to
true
, the rectangle is drawn without a fill. If the
bSuppressStroke
parameter is set to
true
, the rectangle is drawn without a stroke. If both
bSuppressFill
and
bSuppressStroke
are set to
true
, the method has no effect.