Adobe 38039481 User Guide - Page 78

FLASH CS3 72 User Guide You can use the _root alias to refer to the main Timeline of the current level. For the main Timeline, the _root alias stands for _level0 when targeted by a movie clip also on _level0. For a document loaded into _level5, _root is equal to _level5 when targeted by a movie clip also on level 5. For example, if the movie clips southcarolina and florida are both loaded into the same level, an action called from the instance southcarolina could use the following absolute path to target the instance florida: _root.eastCoast.florida About relative paths A relative path depends on the relationship between the controlling Timeline and the target Timeline. Relative paths can address targets only within their own level of Flash Player. For example, you can't use a relative path in an action on _level0 that targets a Timeline on _level5. In a relative path, use the keyword this to refer to the current Timeline in the current level; use the _parent alias to indicate the parent Timeline of the current Timeline. You can use the _parent alias repeatedly to go up one level in the movie clip hierarchy within the same level of Flash Player. For example, _parent._parent controls a movie clip up two levels in the hierarchy. The topmost Timeline at any level in Flash Player is the only Timeline with a _parent value that is undefined. An action in the Timeline of the instance charleston, located one level below southcarolina, could use the following target path to target the instance southcarolina: _parent To target the instance eastCoast (one level up) from an action in charleston, you could use the following relative path: _parent._parent To target the instance atlanta from an action in the Timeline of charleston, you could use the following relative path: _parent._parent.georgia.atlanta Relative paths are useful for reusing scripts. For example, you could attach the following script to a movie clip that magnifies its parent by 150%: onClipEvent (load) {_parent._xscale = 150;_parent._yscale = 150; } You can reuse this script by attaching it to any movie clip instance. Note: Flash Lite 1.0 and 1.1 support attaching scripts only to buttons. Attaching scripts to movie clips is not supported. Whether you use an absolute or a relative path, you identify a variable in a Timeline or a property of an object with a dot (.) followed by the name of the variable or property. For example, the following statement sets the variable name in the instance form to the value "Gilbert": _root.form.name = "Gilbert"; Using absolute and relative target paths You can use ActionScript to send messages from one timeline to another. The timeline that contains the action is called the controlling timeline, and the timeline that receives the action is called the target timeline. For example, there could be an action on the last frame of one timeline that tells another timeline to play. To refer to a target timeline, you must use a target path, which indicates the location of a movie clip in the display list. The following example shows the hierarchy of a document named westCoast on level 0, which contains three movie clips: california, oregon, and washington. Each of these movie clips in turn contains two movie clips.