Adobe Extending Flash Professional CS5 - Manual (Page 89)

67 EXTENDING FLASH PROFESSIONAL
Document object
Last updated 5/2/2011
Parameters
boundingRectangle A rectangle that specifies the bounds within which the new oval primitive is added. For
information on the format of boundingRectangle, see document.addNewRectangle() .
bSuppressFill A Boolean value that, if set to true , causes the method to create the oval 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 oval without a stroke. The
default value is false . This parameter is optional.
Returns
Nothing.
Description
Method; adds a new oval primitive fitting into the specified bounds. This method performs the same operation as the
Oval Primitive tool. The oval 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 oval primitives within the specified coordinates, with and without fill and stroke:
// Add an oval primitive with fill and stroke
fl.getDocumentDOM().addNewPrimitiveOval({left:0,top:0,right:100,bottom:100});
// Add an oval primitive without a fill
fl.getDocumentDOM().addNewPrimitiveOval({left:100,top:100,right:200,bottom:200}, true);
// Add an oval primitive without a stroke
fl.getDocumentDOM().addNewPrimitiveOval({left:200,top:200,right:300,bottom:300},false,true);
See also
document.addNewOval()
document.addNewPrimitiveRectangle()
Availability
Flash CS4 Professional.
Usage
document.addNewPrimitiveRectangle( boundingRectangle, roundness, [, bSuppressFill [,
bSuppressStroke ]] ))
Parameters
rect A rectangle that specifies the bounds within which the new rectangle primitive is added. For information on the
format of boundingRectangle, see document.addNewRectangle() .
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.