MovieClip.getInstanceAtDepth()

Availability

Flash Player 7.

Usage

my_mc.getInstanceAtDepth(depth)

Parameters

depth An integer that specifies the depth level to query.

Returns

A string representing the name of the movie clip located at the specified depth, or undefined if there is no movie clip at that depth.

Description

Method; lets you determine if a particular depth is already occupied by a movie clip. You can use this method before using MovieClip.attachMovie(), MovieClip.duplicateMovieClip(), or MovieClip.createEmptyMovieClip() to determine if the depth parameter you want to pass to any of these methods already contains a movie clip. For more information, see Managing movie clip depths.

See also

MovieClip.getDepth(), MovieClip.getNextHighestDepth(), MovieClip.swapDepths()