What's New in Director 8.5 > Working with Flash 5 > tellTarget, endTellTarget

 

tellTarget, endTellTarget

Syntax

sprite(whichSprite).tellTarget("targetName"), sprite(whichSprite).endTellTarget() 

Definition

Commands; equivalent to Flash's 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.

Examples

This command sets the movie clip as the target:

sprite(1).tellTarget("\myMovieClip")

This command stops the movie clip:

sprite(1).stop() 

This command causes the movie clip to play:

sprite(1).play()

This command sets the focus back to the main Timeline:

sprite(1).endTellTarget() 

This command stops the main movie:

sprite(1).stop()