FLASH® LITE™ 2.x - Adobe Help and Support

Returns
MovieClip - A reference to the MovieClip instance located at the specified depth, or
undefined if there is no movie clip at that depth.
Example
The following example displays the depth occupied by the triangle movie clip instance in
the Output panel:
this.createEmptyMovieClip("triangle", 1);
triangle.beginFill(0x0000FF, 100);
triangle.moveTo(100, 100);
triangle.lineTo(100, 150);
triangle.lineTo(150, 100);
triangle.lineTo(100, 100);
trace(this.getInstanceAtDepth(1)); // output: _level0.triangle
See also
attachMovie (MovieClip.attachMovie method), duplicateMovieClip
(MovieClip.duplicateMovieClip method), createEmptyMovieClip
(MovieClip.createEmptyMovieClip method), getDepth (MovieClip.getDepth
method), getNextHighestDepth (MovieClip.getNextHighestDepth method),
swapDepths (MovieClip.swapDepths method)
getNextHighestDepth
(MovieClip.getNextHighestDepth method)
public getNextHighestDepth() : Number
Determines a depth value that you can pass to MovieClip.attachMovie(),
MovieClip.duplicateMovieClip(), or MovieClip.createEmptyMovieClip() to ensure
that Flash renders the movie clip in front of all other objects on the same level and layer in the
current movie clip. The value returned is 0 or higher (that is, negative numbers are not
returned).
You can extend the methods and event handlers of the MovieClip class by creating a subclass.
Note: You should not use this method if you are also using V2 components. If you placed a V2
component either on the stage or in the library, the getNextHighestDepth() method returns
depth 1048676, which is outside the valid range. This can prevent successful calls to
MovieClip.removeMovieClip().
MovieClip 429