MovieClip.getNextHighestDepth()

Availability

Flash Player 7.

Usage

my_mc.getNextHighestDepth()

Parameters

None.

Returns

An integer that reflects the next available depth index that would render above all other objects on the same level and layer within my_mc.

Description

Method; lets you determine 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).

For more information, see Managing movie clip depths.

See also

MovieClip.getDepth(), MovieClip.getInstanceAtDepth(), MovieClip.swapDepths()