Flash CS3 Documentation

ActionScript 2.0 Language Reference > ActionScript language elements > Global Functions > targetPath function

targetPath function

targetPath(targetObject:Object) : String

Returns a string containing the target path of a MovieClip, Button, TextField, or Videoobject. The target path is returned in dot (.) notation. To retrieve the target path in slash (/) notation, use the _target property.

Availability: ActionScript 1.0; Flash Player 5 - Support for Button, TextField, and Video objects added in Flash Player 6.

Parameters

targetObject:Object - Reference (for example, _root or _parent ) to the object for which the target path is being retrieved. This can be a MovieClip, Button, or TextField object.

Returns

String - A string containing the target path of the specified object.

Example

The following example traces the target path of a movie clip as soon as it loads:

this.createEmptyMovieClip("myClip_mc", this.getNextHighestDepth());
trace(targetPath(myClip_mc)); // _level0.myClip_mc

See also

eval function

Flash CS3