MACROMEDIA FLASH 8-EXTENDING FLASH, Manual

Page: 487 / 554

Timeline object 487
If the specified or selected frame is a regular frame, the frame is inserted at that frame. For
example, if you have a span of 10 frames numbered 1-10 and you select Frame 5 (or pass a
value of 4 for
frameIndex
), this method adds a frame at Frame 5, and the length of the frame
span becomes 11 frames. If Frame 5 is selected and it is a keyframe, this method inserts a
frame at Frame 6 regardless of whether the frame next to it is also a keyframe.
Example
The following example inserts a frame (or frames, depending on the selection) at the current
selection in the current layer:
fl.getDocumentDOM().getTimeline().insertFrames();
The following example inserts five frames at the current frame in all layers:
fl.getDocumentDOM().getTimeline().insertFrames(5);
The following example inserts three frames in the current layer only:
fl.getDocumentDOM().getTimeline().insertFrames(3, false);
The following example inserts four frames in all layers, starting from the first frame:
fl.getDocumentDOM().getTimeline().insertFrames(4, true, 0);
timeline.insertKeyframe()
Availability
Flash MX 2004.
Usage
timeline.insertKeyframe([ frameNumIndex ])
Parameters
frameNumIndex
A zero-based index that specifies the frame index at which to insert the
keyframe in the current layer. If you omit
frameNumIndex
, the method uses the frame
number of the current playhead or selected frame. This parameter is optional.
Returns
Nothing.
NO
TE
If you have multiple layers with frames in them, and you select a frame in one layer when
using the previous command, Flash inserts the frames in the selected layer only. If you
have multiple layers with no frames selected in them, Flash inserts the frames in all
layers.