Adobe Extending Flash Professional CS4 - Manual (Page 160)

138 EXTENDING FLASH CS4 PROFESSIONAL
Document object
Parameters
None.
Returns
Nothing.
Description
Method; selects all items on the Stage. This method is equivalent to pressing Control+A (Windows) or Command+A
(Macintosh) or selecting Edit > Select All.
Example
The following example selects everything that is currently visible to the user:
fl.getDocumentDOM().selectAll();
See also
document.selection , document.selectNone()
document.selection
Availability
Flash MX 2004.
Usage
document.selection
Description
Property; an array of the selected objects in the document. If nothing is selected, returns an array of length zero. If no
document is open, returns
null .
To add objects to the array, you must first select them in one of the following ways:
• Manually select object(s) on the Stage.
• Use one of the selection methods, such as document.setSelectionRect() , document.setSelectionBounds() ,
document.mouseClick() , document.mouseDblClk() , or document.selectAll() .
• Manually select a frame or frames.
• 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 all the elements in a particular frame (see Element object ). See the first example below.
• Create an array of one or more elements and then assign that array to the document.selection array. See the third
example below.
Example
The following example assigns all elements on Frame 11 to the current selection (remember that index values are
different from frame number values):