User Guide

651
Examples
A multiple-line tell command resembles a handler and requires an end tell statement:
global childMovie
tell window childMovie
go to frame "Intro"
the stageColor = 100
sprite(4).member = member "Diana Ross"
updateStage
end tell
When a message calls a handler, a value returned from the handler can be found in the global
result property after the called handler is done. These statements send the childMovie window the
message calcBalance and then return the result:
global childMovie
tell window childMovie to calcBalance
-- a handler name
myBalance = result()
-- return value from calcBalance handler
When you use the tell command to send a message from a movie playing in a window to the
main movie, use the
stage system property as the object name:
tell the stage to go frame "Main Menu"
When you use the tell command to call a handler in another movie, make sure that you do not
have a handler by the same name in the same script in the local movie. If you do, the local script
will be called. This restriction applies only to handlers in the same script in which you are using
the
tell command.
This statement causes the Control Panel window to instruct the Simulation movie to branch to
another frame:
tell window "Simulation" to go frame "Save"
tellStreamStatus()
Syntax
tellStreamStatus(onOrOffBoolean)
Description
Function; turns the stream status handler on (TRUE) or off (FALSE).
The form
tellStreamStatus() determines the status of the handler.
When the
streamStatusHandler is TRUE, Internet streaming activity causes periodic calls to the
movie script, triggering streamStatusHandler. The handler is executed, with Director
automatically filling in the parameters with information regarding the progress of the downloads.