MACROMEDIA FLASH 8-EXTENDING FLASH, Manual

Page: 486 / 554

486 Objects
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.
If no parameters are specified, this method works as follows:
■
If one or more frames are selected, the method inserts the selected number of frames at the
location of the first selected frame in the current layer. That is, if frames 6 through 10 are
selected (a total of five frames), the method adds five frames at Frame 6 in the layer
containing the selected frames.
■
If no frames are selected, the method inserts one frame at the current frame on all layers.
If parameters are specified, the method works as follows:
■
If only
numFrames
is specified, inserts the specified number of frames at the current frame
on the current layer.
■
If
numFrames
is specified and
bAllLayers
is
true
, inserts the specified number of frames
at the current frame on all layers.
■
If all three parameters are specified, inserts the specified number of frames at the specified
index (
frameIndex
); the value passed for
bAllLayers
determines if the frames are added
only to the current layer or to all layers.