public getNextHighestDepth() : Number

現在のムービークリップ内の同一レベル、同一レイヤー上の他のすべてのオブジェクトよりもムービークリップを前面に表示する場合に、MovieClip.attachMovie() メソッド、MovieClip.duplicateMovieClip() メソッド、または MovieClip.createEmptyMovieClip() メソッドに渡す深度値を調べることができます。返される値は 0 以上です。負の値は返されません。

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

メモ : V2 コンポーネントも使用している場合は、このメソッドは使用しないでください。V2 コンポーネントをステージまたはライブラリに配置すると、getNextHighestDepth() メソッドは有効範囲外にある深度 1048676 を返します。この結果、MovieClip.removeMovieClip() を正常に呼び出せなくなる可能性があります。

戻り値

Number - ムービークリップ内で、同一レベル、同一レイヤー上に存在する他のすべてのオブジェクトをレンダリングできる次に使用可能な深度インデックスを示す整数。

例

次の例では、createEmptyMovieClip() メソッドの depth パラメータとして getNextHighestDepth() メソッドを使用して、3 つのムービークリップインスタンスを描画します。各ムービークリップに、その深度のラベルを付けます。

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 (MovieClip.getDepth メソッド), getInstanceAtDepth (MovieClip.getInstanceAtDepth メソッド), swapDepths (MovieClip.swapDepths メソッド), attachMovie (MovieClip.attachMovie メソッド), duplicateMovieClip (MovieClip.duplicateMovieClip メソッド), createEmptyMovieClip (MovieClip.createEmptyMovieClip メソッド)