screenOutline.renameScreen()

Availability

Flash MX 2004.

Usage

screenOutline.renameScreen(newScreenName [, oldScreenName
[, bDisplayError]])

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");