LayerCollection object

記述

app.project.item(index).layers

概要

LayerCollection objectはレイヤーのセットを表します。 LayerCollection objectは、このアイテム(必然的にコンポジション)のCompItem objectに所属しています。コレクションオブジェクトのメソッドはユーザーがレイヤーリストを扱うことを許可しています。

LayerCollection objectはコンポジションに含まれるすべてのLayer objectの配列となっています。ですので、以下の例はどちらも同じレイヤーオブジェクトです。

app.project.item(1).layer(1)

app.project.item(1).layers[1]

指定したアイテムがコンポジションである必要があるために、事前に

app.project.item(1) instanceof CompItem

などを判定して、指定したアイテムがコンポジションした方が良いでしょう。コンポジションでないアイテムでLayerCollectionにアクセスしようとするとundefinedが返されますので、それで判定することもできます。

LayerCollectionはCollectionのサブクラスです。Collectionのすべてのメソッドとアトリビュートと下に挙げた追加メソッドがLayerCollectionで使用可能です。

サンプル

var firstComp = app.project.item(1);

var layerCollection = firstComp.layers;

alert("number of layers before is " + layerCollection.length);

var anAVItem = app.project.item(2);

layerCollection.add(anAVItem);

alert("number of layers after is " + layerCollection.length);

Methods