beautypg.com

Screenoutline.rootscreen, Screenoutline.screens – Adobe Extending Flash Professional CS4 User Manual

Page 403

background image

381

EXTENDING FLASH CS4 PROFESSIONAL

ScreenOutline object

Parameters

newScreenName

A string that specifies the new name of the screen.

oldScreenName

A string that specifies the name of the existing screen to change. If not specified, the name of the

currently selected screen changes. This parameter is optional.

bDisplayError

A Boolean value that, if set to

true

, shows an error message if an error occurs—for example, if a screen

with the same name as the value passed to newScreenName already exists. The default value is

false

.

Returns
A Boolean value:

true

if the renaming is successful;

false

otherwise.

Description
Method; changes the screen with a specified name to a new name.

Example
The following example changes the name of

slide1

to

Intro

:

fl.getDocumentDOM().screenOutline.renameScreen("Intro", "slide1");

screenOutline.rootScreen

Availability
Flash MX 2004.

Usage

screenOutline.rootScreen

Description
Read-only property; the first screen in the screen outline. You can use

screenOutline.rootScreen

as a shortcut for

screenOutline.screens[0]

.

Example
The following example displays the name of the first child of the first screen in the screen outline:

var n = fl.getDocumentDOM().screenOutline.rootScreen.childScreens[0].name;

fl.trace(n);

screenOutline.screens

Availability
Flash MX 2004.

Usage

screenOutline.screens