MACROMEDIA DIRECTOR MX 2004, Reference

Page: 561 / 1130

tellTarget() 561
Example
This
on prepareMovie
handler turns the
on streamStatus
handler on when the movie starts:
-- Lingo syntax
on prepareMovie
tellStreamStatus(TRUE)
end
// JavaScript syntax
function prepareMovie() {
tellStreamStatus(TRUE);
}
This statement determines the status of the stream status handler:
-- Lingo syntax
on mouseDown
put tellStreamStatus()
end
// JavaScript syntax
function mouseDown() {
put(tellStreamStatus());
}
See also
on streamStatus
tellTarget()
Usage
-- Lingo syntax
spriteObjRef .tellTarget( targetName )
// JavaScript syntax
spriteObjRef .tellTarget( targetName );
Description
Command; equivalent to the Flash
beginTellTarget
and
endTellTarget
methods. The
tellTarget()
command allows the user to set a target Timeline on which subsequent sprite
commands will act. When the target is set to a Flash movie clip or a level containing a loaded
Flash movie, certain commands act on the targeted components, rather than on the main
Timeline. To switch focus back to the main Timeline, call
endTellTarget()
.
The only valid argument for
tellTarget
is the target name. There is no valid argument for
endTellTarget
.
The Flash sprite functions that are affected by
tellTarget
are
stop
,
play
,
getProperty
,
setProperty
,
gotoFrame
,
call(frame)
, and
find(label)
. In addition, the sprite property
frame
(which returns the current frame) is affected by
tellTarget
.
Parameters
targetName
Required. Specifies the target name.