Document.addnewrectangle() – Adobe Extending Flash Professional CS4 User Manual
Page 92
70
EXTENDING FLASH CS4 PROFESSIONAL
Document object
Returns
An integer that is the index of the new profile in the profiles list. Returns -1 if a new profile cannot be created.
Description
Method; adds a new publish profile and makes it the current one.
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.