MACROMEDIA FLASH 8-EXTENDING FLASH, Manual

Page: 370 / 554

370 Objects
Example
The following example checks to see if the first screen in the outline is hidden and changes the
visibility of the screen accordingly. Then, a message in the Output panel shows what the
visibility of the screen was before the change:
if (fl.getDocumentDOM().screenOutline.screens[0].hidden) {
fl.getDocumentDOM().screenOutline.setScreenProperty("hidden", false);
fl.trace(fl.getDocumentDOM().screenOutline.screens[0].name+" had its
'hidden' property set to 'false'");
}
else {
fl.getDocumentDOM().screenOutline.setScreenProperty("hidden", true);
fl.trace(fl.getDocumentDOM().screenOutline.screens[0].name+" had its
'hidden' property set to 'true'");
}
screen.instanceName
Availability
Flash MX 2004.
Usage
screen.instanceName
Description
Read-only property; a string that represents the instance name used to access the object from
ActionScript.
Example
The following example checks to see if the current document allows screens (because it is a
slide or form). Then, it assigns the
instanceName
value of the first child screen in the array to
the
myInstanceName
variable and opens the Output panel to show the instance name of
the screen:
var myChildren = new Array();
if(fl.getDocumentDOM().allowScreens) {
var myInstanceName =
fl.getDocumentDOM().screenOutline.rootScreen.childScreens[0].instanceNam
e;
fl.trace(" The instanceName is "+myInsta". ");
}