Adobe Extending Flash Professional CS4 - Manual (Page 487)

465 EXTENDING FLASH CS4 PROFESSIONAL
Timeline object
timeline.addMotionGuide()
Availability
Flash MX 2004.
Usage
timeline.addMotionGuide()
Parameters
None.
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. Acceptable values are "normal" , "guide" , "guided" , "mask" , "masked" , and "folder" .
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.