
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.
Commentaires sur ces manuels