public getNextHighestDepth() : Number

Permet de déterminer une valeur de profondeur que vous pouvez transmettre à MovieClip.attachMovie(), MovieClip.duplicateMovieClip(), ou MovieClip.createEmptyMovieClip() afin de vous assurer que Flash rende le clip devant tous les autres objets sur les mêmes niveau et calque dans le clip actuel. La valeur renvoyée est plus grande ou égale à 0 (autrement dit, les nombres négatifs ne sont pas renvoyés).

Vous pouvez étendre les méthodes et les gestionnaires d’événements de la classe MovieClip en créant une sous-classe.

Remarque : Si vous utilisez des composants de la version 2, n’utilisez pas cette méthode. Si vous placez un composant de la version 2 sur la scène ou dans la bibliothèque, la méthode getNextHighestDepth() renvoie parfois une valeur de profondeur de 1048676, qui est en dehors de la limite valide. Si vous utilisez des composants de la version 2, vous devez toujours utiliser les composants de la version 2 de la classe DepthManager.

Disponibilité : ActionScript 1.0 ; Flash Player 7

Number - Entier reflétant le prochain index de profondeur disponible rendu au-dessus de tous les autres objets au même niveau et sur le même calque dans le clip.

L’exemple suivant dessine trois occurrences de clip, en utilisant la méthode getNextHighestDepth() comme paramètre depth de la méthode createEmptyMovieClip() et étiquette chaque clip avec sa profondeur :

for (i = 0; i < 3; i++) {
     drawClip(i);
}
 
function drawClip(n:Number):Void {
     this.createEmptyMovieClip("triangle" + n, this.getNextHighestDepth());
     var mc:MovieClip = eval("triangle" + n);
     mc.beginFill(0x00aaFF, 100);
     mc.lineStyle(4, 0xFF0000, 100);
     mc.moveTo(0, 0);
     mc.lineTo(100, 100);
     mc.lineTo(0, 100);
     mc.lineTo(0, 0);
     mc._x = n * 30;
     mc._y = n * 50
     mc.createTextField("label", this.getNextHighestDepth(), 20, 50, 200, 200)
     mc.label.text = mc.getDepth();
}

getDepth (méthode MovieClip.getDepth), getInstanceAtDepth (méthode MovieClip.getInstanceAtDepth), swapDepths (méthode MovieClip.swapDepths), attachMovie (méthode MovieClip.attachMovie), duplicateMovieClip (méthode MovieClip.duplicateMovieClip), createEmptyMovieClip (méthode MovieClip.createEmptyMovieClip)