MACROMEDIA FLASH 8-FLASH LITE 2.X ACTIONSCRIPT LANGUAGE - Getnexthighestdepth (Movieclip.getnexthighestdepth Method)

MovieClip 471
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().
Availability: ActionScript 1.0; Flash Lite 2.0
Returns
Number - An integer that reflects the next available depth index that would render above all
other objects on the same level and layer within the movie clip.