FolderDocument.Items object

 

 

Prototype for FolderDocument.Items objects

Syntax

You cannot create a FolderDocument.Items object. You can only access it from FolderDocument.Item:

var folder_item;
var children_items = folder_item.children;

Parameters

none.

Property Of

none.

Implemented In

ECMerge 2.1

Description

FolderDocument.Items is a Read-Only, Array-like, object which allows you to gain access to a list of items. Usually the children (i.e. contained) items of a folder document item.
Until the fill ( ) method is called, you are not ensured that all the children are actually listed (this is to accomodate with some asynchronous protocols).

Properties

Property	Description
is_filled	Boolean. Read-Only. True if the requests to fill children items all finished.
length	Integer. Number of contained items
0..length-1	FolderDocument.Item object. nth contained item.

 

Methods

fill

Examples

see FolderDocument.Item examples.

See Also 

 FolderDocument.Item object

Method fill

Syntax

function fill ( )

Parameters

none.

Method Of

FolderDocument.Items object

Implemented In

ECMerge 2.1

Description

Forces the content of the 'children' Array to be filled, waiting until all launched requests actually terminate.

Examples

Example 1.

Enumerate the children names of the root item:

var folder_doc = current_frame.coordinator.document;
var root_item_children = folder_doc.root.children;
root_item_children.fill ();