FolderItem object

The FolderItem object corresponds to a folder in your Project panel. It can contain various types of items (footage, compositions, solids) as well as other folders.

Syntax

app.project.FolderItem

Example

Given that the second item in the project is a FolderItem, the following code puts up an alert for each top-level item in the folder, showing that item’s name.

var secondItem = app.project.item(2);
if ( !(secondItem instanceof FolderItem) ) {
    alert("problem: second item is not a folder");
    } else {
    for (i = 1; i <= secondItem.numItems; i++) {
    alert("item number " + i + " within the folder is named "
    + secondItem.item(i).name);
    }
}

Attribute List

Attribute	Description
items	The contents of this folder.
numItems	The number of items contained in the folder.

Method List

Method	Description
item()	Gets an item from the folder.

Detailed Information

item() method

Syntax: app.project.item(index).item

Description: Returns the top-level item in this folder at the specified index position. Note that “top-level” here means top-level within the folder, not necessarily within the project.

Parameters * index An integer, the position index of the item to retrieve. The first item is at index 1.

Returns: Item object.

items attribute

Syntax: app.project.item(index).items

Description: An ItemCollection object containing Item object that represent the top-level contents of this folder. Unlike the ItemCollection in the Project object, this collection contains only the top-level items in the folder. Top-level within the folder is not the same as top-level within the project. Only those items that are top-level in the root folder are also top-level in the Project.

Type: ItemCollection object; read only.

numItems attribute

Syntax: app.project.item(index).numItems

Description: The number of items contained in the items collection (folderItem.items.length). If the folder contains another folder, only the FolderItem for that folder is counted, not any subitems contained in it.

Type: Integer; read only.