Document.addnewrectangle() – Adobe Extending Flash Professional CS5 User Manual
Page 91
69
EXTENDING FLASH PROFESSIONAL
Document object
Last updated 5/2/2011
Example
The following example adds a new publish profile with a default name and then displays the name of the profile in the
Output panel:
fl.getDocumentDOM().addNewPublishProfile();
fl.outputPanel.trace(fl.getDocumentDOM().currentPublishProfile);
The following example adds a new publish profile with the name "
my profile"
:
fl.getDocumentDOM().addNewPublishProfile("my profile");
See also
document.deletePublishProfile()
document.addNewRectangle()
Availability
Flash MX 2004.
Usage
document.addNewRectangle(boundingRectangle, roundness
[, bSuppressFill [, bSuppressStroke]])
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 corner of the Stage) and the
right
and
bottom
values
specify the 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.