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

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()
, or to ensure
MovieClip.duplicateMovieClip() MovieClip.createEmptyMovieClip()
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 method returns
getNextHighestDepth()
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
- An integer that reflects the next available depth index that would render above all
Number
other objects on the same level and layer within the movie clip.
MovieClip 471