screenOutline.duplicateScreen()

Availability

Flash MX 2004.

Usage

screenOutline.duplicateScreen([screenName])

Parameters

screenName A string value that specifies the screen name to duplicate. If you don't pass a value for screenName, the currently selected screen(s) are duplicated. This parameter is optional.

Returns

A Boolean value: true if the screen is successfully duplicated; false otherwise.

Description

Method; duplicates the currently selected screen(s) or a specified screen. The duplicate screens are given a default name by appending _copy to the original name, such as Screen_copy, Screen_copy2, and so on. If you duplicate multiple screens, the duplicates are placed directly below the selected screen that is lowest in the screen outline hierarchy.

Example

The following example duplicates a screen named apple:

fl.getDocumentDOM().screenOutline.duplicateScreen("apple");