timeline.expandFolder()

Availability

Flash MX 2004.

Usage

timeline.expandFolder(bExpand [, bRecurseNestedParents [, index]])

Parameters

bExpand

A Boolean value that, if set to true, causes the method to expand the folder; false causes the method to collapse the folder.

bRecurseNestedParents

A Boolean value that, if set to true, causes all the layers within the specified folder to be opened or closed, based on the bExpand parameter. This parameter is optional.

index

A zero-based index of the folder to expand or collapse. Use ‑1 to apply to all layers (you also must set bRecurseNestedParents to true). This property is equivalent to the Expand All/Collapse All menu items in the Flash authoring tool. This parameter is optional.

Returns

Nothing.

Description

Method; expands or collapses the specified folder or folders. If you do not specify a layer, this method operates on the current layer.

Example

The following examples use this folder structure:

Folder 1 ***  
--layer 7  
--Folder 2 ****  
----Layer 5 

The following example expands Folder 1 only:

fl.getDocumentDOM().getTimeline().currentLayer = 1; 
fl.getDocumentDOM().getTimeline().expandFolder(true); 

The following example expands Folder 1 only (assuming that Folder 2 collapsed when Folder 1 last collapsed; otherwise, Folder 2 appears expanded):

fl.getDocumentDOM().getTimeline().expandFolder(true, false, 0);

The following example collapses all folders in the current timeline:

fl.getDocumentDOM().getTimeline().expandFolder(false, true, -1);