Adobe Extending Flash Professional CS4 - Manual (Page 302)

280 EXTENDING FLASH CS4 PROFESSIONAL
Frame object
Description
Read-only property; an integer that represents the number of frames in a frame sequence.
Example
The following example stores the number of frames in a frame sequence that starts at the first frame in the top layer in
the
frameSpan variable:
var frameSpan = fl.getDocumentDOM().getTimeline().layers[0].frames[0].duration;
frame.elements
Availability
Flash MX 2004.
Usage
frame.elements
Description
Read-only property; an array of Element objects (see
Element object ). The order of elements is the order in which they
are stored in the FLA file. If there are multiple shapes on the Stage, and each is ungrouped, Flash treats them as one
element. If each shape is grouped, so there are multiple groups on the Stage, Flash sees them as separate elements. In
other words, Flash treats raw, ungrouped shapes as a single element, regardless of how many separate shapes are on
the Stage. If a frame contains three raw, ungrouped shapes, for example, then
elements.length in that frame returns
a value of 1. To work around this issue, select each shape individually and group it .
Example
The following example stores an array of current elements in the top layer, first frame in the
myElements variable:
var myElements = fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements;
frame.getCustomEase()
Availability
Flash 8.
Usage
Frame.getCustomEase([property])
Parameters
property An optional string that specifies the property for which you want to return the custom ease value.
Acceptable values are "all" , "position" , "rotation" , "scale" , "color" , and "filters" . The default value is
"all" .
Returns
Returns an array of JavaScript objects, each of which has an x and y property.