Document.addnewpublishprofile() – Adobe Extending Flash Professional CS4 User Manual
Page 91

69
EXTENDING FLASH CS4 PROFESSIONAL
Document object
Parameters
rect
A rectangle that specifies the bounds within which the new rectangle primitive is added. For information on the
format of boundingRectangle, see
.
roundness
An integer between
0 and
999 that represents the number of points used to specify how much the corners
should be rounded.
bSuppressFill
A Boolean value that, if set to
true
, causes the method to create the rectangle 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 primitive fitting into the specified bounds. This method performs the same operation
as the Rectangle Primitive tool. The rectangle primitive uses the document's current default stroke and fill attributes
and is added on the current frame and layer. If both bSuppressFill and bSuppressStroke are set to
true
, the method has
no effect.
Example
The following example adds rectangle primitives within the specified coordinates, with and without fill and stroke, and
with different amounts of roundness:
// Add a rectangle primitive with fill and stroke
fl.getDocumentDOM().addNewPrimitiveRectangle({left:0,top:0,right:100,bottom:100}, 0);
// Add a rectangle primitive without a fill
fl.getDocumentDOM().addNewPrimitiveRectangle({left:100,top:100,right:200,bottom:200}, 20,
true);
// Add a rectangle primitive without a stroke
fl.getDocumentDOM().addNewPrimitiveRectangle({left:200,top:200,right:300,bottom:300},
50,false,true);
See also
document.addNewPublishProfile()
Availability
Flash MX 2004.
Usage
document.addNewPublishProfile([profileName])
Parameters
profileName
The unique name of the new profile. If you do not specify a name, a default name is provided. This
parameter is optional.