Adobe Extending Flash Professional CS5 - Manual (Page 504)

482 EXTENDING FLASH PROFESSIONAL
Timeline object
Last updated 5/2/2011
If the specified or selected frame is a regular frame, the keyframe is inserted at the frame. For example, if you have a
span of 10 frames numbered 1-10 and you select Frame 5, this method makes Frame 5 a blank keyframe, and the length
of the frame span is still 10 frames. If Frame 5 is selected and is a keyframe with a regular frame next to it, this method
inserts a blank keyframe at Frame 6. If Frame 5 is a keyframe and the frame next to it is already a keyframe, no keyframe
is inserted but the playhead moves to Frame 6.
Returns
Nothing.
Description
Method; inserts a blank keyframe at the specified frame index; if the index is not specified, the method inserts the blank
keyframe by using the playhead/selection. See also
timeline.insertKeyframe() .
Example
The following example inserts a blank keyframe at Frame 20 (remember that index values are different from frame
number values):
fl.getDocumentDOM().getTimeline().insertBlankKeyframe(19);
The following example inserts a blank keyframe at the currently selected frame (or playhead location if no frame is
selected):
fl.getDocumentDOM().getTimeline().insertBlankKeyframe();
timeline.insertFrames()
Availability
Flash MX 2004.
Usage
timeline.insertFrames([numFrames [, bAllLayers [, frameNumIndex]]])
Parameters
numFrames An integer that specifies the number of frames to insert. If you omit this parameter, the method inserts
frames at the current selection in the current layer. This parameter is optional.
bAllLayers A Boolean value that, if set to true (the default), causes the method to insert the specified number of
frames in the numFrames parameter into all layers; if set to false , the method inserts frames into the current layer.
This parameter is optional.
frameNumIndex A zero-based index that specifies the frame at which to insert a new frame. This parameter is
optional.
Returns
Nothing.
Description
Method; inserts the specified number of frames at the specified index.