User Guide

252 Chapter 3: Objects
screen.name
Availability
Flash MX 2004.
Usage
screen.name
Description
Read-only property; a string that represents the name of the screen.
Example
The following example checks to see if the current document allows screens (because it is a slide
or form document). Then, it assigns the
name value of the first child screen in the array to the
myName variable and opens the Output panel to show the name of the screen:
var myChildren = new Array();
if(fl.getDocumentDOM().allowScreens) {
var myName =
fl.getDocumentDOM().screenOutline.rootScreen.childScreens[0].name;
fl.trace("The name of the screen is "+myName+". ");
}
screen.nextScreen
Availability
Flash MX 2004.
Usage
screen.nextScreen
Description
Read-only property; an object that represents the next peer screen in the parent’s childScreen
array. That is,
screen.NextScreen is found by moving down an array of child screens to the next
screen in the array. See
screen.prevScreen.
If there isnt a peer screen, the value is
null.
Example
The following example first checks to see if the current document is a slide or form, and if it is,
retrieves and shows the sequence of screens in the Output panel:
if(fl.getDocumentDOM().allowScreens) {
var myCurrent =
fl.getDocumentDOM().screenOutline.rootScreen.childScreens[0].name;
var myNext =
fl.getDocumentDOM().screenOutline.rootScreen.childScreens[0].nextScreen.nam
e;
fl.trace(" The next screen to "+myCurrent+" is "+myNext+". ");
}