Swapdepths (Movieclip.swapdepths Method) - MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE Reference

swapDepths (MovieClip.swapDepths method)

public swapDepths(target:Object) : Void
Swaps the stacking, or depth level (z-order), of this movie clip with the movie clip that is
specified by the
target
level that is specified in the
movie clip. Swapping the depth level of movie clips has the effect of moving one movie clip in
front of or behind the other. If a movie clip is tweening when this method is called, the
tweening is stopped.
You can extend the methods and event handlers of the MovieClip class by creating a subclass.
Availability: ActionScript 1.0; Flash Player 5
Parameters
- This parameter can take one of two forms:
target:Object
A Number that specifies the depth level where the movie clip is to be placed.
A String that specifies the movie clip instance whose depth is swapped with the movie clip
for which the method is being applied. Both movie clips must have the same parent movie
clip.
Example
The following example swaps the stacking order of two movie clip instances. Overlap two
movie clip instances, called
script to the parent Timeline:
myMC1_mc.onRelease = function() {
this.swapDepths(myMC2_mc);
};
myMC2_mc.onRelease = function() {
this.swapDepths(myMC1_mc);
};
See also
,
_level property getDepth (MovieClip.getDepth method)
(MovieClip.getInstanceAtDepth method)
(MovieClip.getNextHighestDepth method)
928 ActionScript classes
parameter, or with the movie clip that currently occupies the depth
parameter. Both movie clips must have the same parent
target
and
myMC1_mc myMC2_mc
, on the Stage and then add the following
,
getInstanceAtDepth
,
getNextHighestDepth