MACROMEDIA FLASH 8-EXTENDING FLASH, Manual

Page: 471 / 554

Timeline object 471
Returns
An integer that represents the zero-based index of the newly added guide layer. If the current
layer type is not of type “Normal”, Flash returns -1.
Description
Method; adds a motion guide layer above the current layer and attaches the current layer to
the newly added guide layer, converting the current layer to a layer of type “Guided”.
This method functions only on a layer of type “Normal”. It has no effect on a layer whose
type is “Folder”, “Mask”, “Masked”, “Guide”, or “Guided”.
Example
The following example adds a motion guide layer above the current layer, and converts the
current layer to
"Guided"
:
fl.getDocumentDOM().getTimeline().addMotionGuide();
timeline.addNewLayer()
Availability
Flash MX 2004.
Usage
timeline.addNewLayer([ name ] [, layerType [, bAddAbove ]])
Parameters
name
A string that specifies the name for the new layer. If you omit this parameter, a new
default layer name is assigned to the new layer (“Layer n,” where n is the total number of
layers). This parameter is optional.
layerType
A string that specifies the type of layer to add. If you omit this parameter, a
“Normal” type layer is created. This parameter is optional.
bAddAbove
A Boolean value that, if set to
true
(the default), causes Flash to add the new
layer above the current layer;
false
causes Flash to add the layer below the current layer. This
parameter is optional.
Returns
An integer value of the zero-based index of the newly added layer.
Description
Method; adds a new layer to the document and makes it the current layer.