public swapDepths(target:Object) : Void

ムービークリップのスタッキング順序、つまり深度 (z 順序) を、target パラメータに指定したムービーと入れ替えます。または、target パラメータに指定した深度に現在置かれているムービーと入れ替えます。両方のムービークリップは、同じ親ムービークリップに属している必要があります。ムービークリップの深度を入れ替えると、あるムービークリップを他のムービークリップの前面または背面に移動させるという効果が得られます。このメソッドを呼び出すときにムービークリップがトゥイーンしている場合、トゥイーンは停止します。 .

サブクラスを作成することにより、MovieClip クラスのメソッドおよびイベントハンドラを拡張できます。

パラメータ

target:Object - このパラメータは、次のいずれかの形式で指定できます。

• ムービークリップを配置する深度を指定する数値。
• 別のムービークリップインスタンスを指定するストリング。指定したムービークリップインスタンスとこのメソッドの適用先ムービークリップの深度が入れ替わります。両方のムービークリップは、同じ親ムービークリップに属している必要があります。

例

次の例では、2 つのムービークリップインスタンスの重ね順を入れ替えます。myMC1_mc と myMC2_mc の 2 つのムービークリップインスタンスをステージ上で重ねた後、親のタイムラインに次のスクリプトを追加します。

myMC1_mc.onRelease = function() {
    this.swapDepths(myMC2_mc);
};
myMC2_mc.onRelease = function() {
    this.swapDepths(myMC1_mc);
};

関連項目

_level プロパティ, getDepth (MovieClip.getDepth メソッド), getInstanceAtDepth (MovieClip.getInstanceAtDepth メソッド), getNextHighestDepth (MovieClip.getNextHighestDepth メソッド)