MACROMEDIA DIRECTOR MX 2004, Reference

Page: 625 / 1130

actorList 625
}
}
See also
Player
actorList
Usage
-- Lingo syntax
_movie.actorList
// JavaScript syntax
_movie.actorList;
Description
Movie property; a list of child objects that have been explicitly added to this list. Read/write.
Objects in
actorList
receive a
stepFrame
message each time the playhead enters a frame.
To add an object to
the actorList
, use
_movie.actorList.append( newScriptObjRef )
. The
object’s
stepFrame
handler in its parent or ancestor script will then be called automatically at
each frame advance.
To clear objects from
the actorList
, set
actorList
to
[ ]
, which is an empty list.
Director doesn’t clear the contents of
actorList
when branching to another movie, which can
cause unpredictable behavior in the new movie. To prevent child objects in the current movie
from being carried over to the new movie, insert the statement
actorList = [ ]
in the
prepareMovie
handler of the new movie.
Example
This statement adds a child object created from the parent script Moving Ball. All three values are
parameters that the script requires.
This statement displays the contents of
actorList
in the Message window:
-- Lingo syntax
put(_movie.actorList)
// JavaScript syntax
put(_movie.actorList);
This statement clears objects from
actorList
.
-- Lingo syntax
_movie.actorList = [] -- using brackets
_movie.actorList = list() -- using list()
// JavaScript syntax
_movie.actorList = list();
See also
Movie , on prepareMovie , on stepFrame