フッテージウィンドウにおいて、そのアイテムがどこのフォルダにあるかを返す。
フォルダオブジェクトを渡すことでフォルダにアイテムを移動できる。
[object CompItem].parentFolder;
例1
myFolder = app.project.item(1);
app.project.item(2).parentFolder = myFolder;
例2
alert(app.project.item(1).parentFolder);
例3
if(app.project.item(1).parentFolder.name == "ルート") alert('this Item on top level');
例3のように最上位に位置するかどうかは、最上位フォルダの名前が言語環境に依存するので
app.project.item(1).parentFolder.parentFolder;
などとするといいかも。
参考