MovieClip.swapDepths()

Availability

Flash Player 5.

Usage

my_mc.swapDepths(depth)
my_mc.swapDepths(target)

Parameters

depth A number specifying the depth level where my_mc is to be placed.

target A string specifying the movie clip instance whose depth is swapped by the instance specified by my_mc. Both instances must have the same parent movie clip.

Returns

Nothing.

Description

Method; swaps the stacking, or z-order (depth level), of the specified instance (my_mc) with the movie clip specified by the target parameter, or with the movie clip that currently occupies the depth level specified in the depth parameter. Both movie clips must have the same parent 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. For more information, see Managing movie clip depths.

See also

_level, MovieClip.getDepth(), MovieClip.getInstanceAtDepth(), MovieClip.getNextHighestDepth()