User Guide

Document object 113
• Use one of the methods of the Timeline object to select a frame or frames, such as
timeline.getSelectedFrames(), timeline.setSelectedFrames(), or
timeline.selectAllFrames().
• Specify a particular element in a particular frame. For example, the following code specifies
and selects an element:
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0];
Example
The following example assigns all elements on Frame 11 to the current selection (remember that
index values are different from frame number values):
fl.getDocumentDOM().getTimeline().currentFrame = 10;
fl.getDocumentDOM().selection =
fl.getDocumentDOM().getTimeline().layers[0].frames[10].elements;
The following example creates a rectangle in the upper left corner of the Stage and a text string
underneath the rectangle. Then it selects both objects using
document.setSelectionRect()
and adds them to the
document.selection array. Finally, it displays the contents of
document.selection in the Output panel.
fl.getDocumentDOM().addNewRectangle({left:0, top:0, right:99, bottom:99}, 0);
fl.getDocumentDOM().addNewText({left:-1, top:117.3, right:9.2, bottom:134.6});
fl.getDocumentDOM().setTextString('Hello World');
fl.getDocumentDOM().setSelectionRect({left:-28, top:-22, right:156.0,
bottom:163});
var theSelectionArray = fl.getDocumentDOM().selection;
for(var i=0;i<theSelectionArray.length;i++){
fl.trace("fl.getDocumentDOM().selection["+i+"] = " + theSelectionArray[i]);
}
The following example is an advanced example. It shows how to loop through the layer array and
elements array to locate instances of a particular symbol and select them. You could extend this
example to include loops for multiple frames or scenes. This example assigns all instances of the
movie clip
"myMovieClip" in the first frame to the current selection:
//assigns the layers array to the variable "theLayers"
var theLayers = fl.getDocumentDOM().getTimeline().layers;
//creates an array to hold all the elements that are instances of "myMovieClip"
var mySelectionArray = new Array;
//counter variable
var x=0;
//begin loop through all the layers
for(var i=0; i < theLayers.length;i++){
//gets the array of elements in frame 1 and assigns it to the array
"theElems"
var theElems = theLayers[i].frames[0].elements;