beautypg.com

Screenoutline.insertscreen() – Adobe Extending Flash Professional CS4 User Manual

Page 401

background image

379

EXTENDING FLASH CS4 PROFESSIONAL

ScreenOutline object

Usage

screenOutline.insertNestedScreen([name [, referenceScreen [, screenTypeName]]])

Parameters

name

A string indicating the name of the new screen to insert. An empty name will insert a screen with a default

screen name, such as Slide n or Form n (where n is the first available unique number). This parameter is optional.

referenceScreen

A string indicating the name of the screen into which the new screen is inserted as a child. If this

parameter is omitted, the new screen is inserted as a child of the currently selected screen. This parameter is optional.

screenTypeName

A string that specifies the screen type to attach to the new nested screen. The screen type and class

name are set for this screen. Acceptable values are

"Form"

and

"Slide"

. This parameter is optional. If this parameter

is omitted, the type is inherited from the parent screen.

Returns
A

Screen object

.

Description
Method; inserts a nested screen of a specific type into a particular location in the screen outline.

Example
The following example inserts

slide2

as a child of

slide1

:

fl.getDocumentDOM().screenOutline.insertNestedScreen("slide2", "slide1", "Slide");

screenOutline.insertScreen()

Availability
Flash MX 2004.

Usage

screenOutline.insertScreen([name [, referenceScreen [, screenTypeName]]])

Parameters

name

A string indicating the name of the new screen to insert. If this parameter is omitted, the method inserts a screen

with a default screen name, such as Slide n or Form n (where n is the first available unique number). This parameter
is optional.

referenceScreen

A string indicating the name of the screen before the new screen. If this parameter is omitted, the new

screen is inserted after the currently selected screen. If the referenceScreen parameter identifies a child screen, the new
screen will be a peer of the child screen, and a child screen of the same parent. This parameter is optional.

screenTypeName

A string that specifies the screen type to attach to the new screen. The screen type and class name

are set for this screen. Acceptable values are

"Form"

and

"Slide"

. This parameter is optional.

Returns
A

Screen object

.