Adobe Extending Flash Professional CS4 - Manual (Page 94)

72 EXTENDING FLASH CS4 PROFESSIONAL
Document object
Example
The following example adds a new scene named
myScene after the current scene in the current document. The variable
success will be true when the new scene is created; false otherwise.
var success = fl.getDocumentDOM().addNewScene("myScene");
The following example adds a new scene using the default naming convention. If only one scene exists, the newly
created scene is named
"Scene 2".
fl.getDocumentDOM().addNewScene();
document.addNewText()
Availability
Flash MX 2004; optional text parameter added in Flash CS3 Professional.
Usage
document.addNewText(boundingRectangle [, text ])
Parameters
boundingRectangle Specifies the size and location of the text field. For information on the format of
boundingRectangle, see document.addNewRectangle() .
text An optional string that specifies the text to place in the field. If you omit this parameter, the selection in the Tools
panel switches to the Text tool. Therefore, if you don’t want the selected tool to change, pass a value for text.
Returns
Nothing.
Description
Method; inserts a new text field and optionally places text into the field. If you omit the text parameter, you can call
document.setTextString() to populate the text field.
Example
The following example creates a new text field in the upper left corner of the Stage and sets the text string to
"Hello
World ":
fl.getDocumentDOM().addNewText({left:0, top:0, right:100, bottom:100} , "Hello World!" );
fl.getDocumentDOM().setTextString('Hello World!');
See also
document.setTextString()
document.align()
Availability
Flash MX 2004.