beautypg.com

Screen.instancename, Screen.name – Adobe Extending Flash Professional CS4 User Manual

Page 392

background image

370

EXTENDING FLASH CS4 PROFESSIONAL

Screen object

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].instanceName;

fl.trace(" The instanceName is "+myInstanceName+". ");

}

screen.name

Availability
Flash MX 2004.

Usage

screen.name

Description
Read-only property; a string that represents the name of the screen.