User Guide

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