IDLitContainer::AddByIdentifier

Syntax | Arguments | Keywords | Version History

The IDLitContainer::AddByIdentifier procedure method adds an object to the container hierarchy in the position specified by the Identifier argument.

Syntax

Obj->[IDLitContainer::]AddByIdentifier, Identifier, Item [, FOLDER_CLASSNAME=string]

Arguments

Identifier

An object identifier specifying the location in the container hierarchy where Item should be added. Identifier can be either a fully-qualified object identifier (beginning with a "/" character) or a relative to the container on which this method is called. If Identifier is a null string (''), Item is added to the root of the container object.

See iTool Object Identifiers (iTool Developer's Guide) for a discussion of object identifier strings.

Item

An object reference to the iTool component object being added to the container.

Keywords

FOLDER_CLASSNAME

If the container hierarchy specified by Identifier contains subfolders that do not exist, the necessary subfolders are created automatically. By default, the created subfolders are of the same class as the calling method (IDLitContainer or one of its subclasses). To create subfolders of a different class, set the FOLDER_CLASSNAME keyword equal to a string specifying the name of the class to be used.

Version History