LISTINS

8.1

The LISTINS instruction adds objects to a COLLECTION or a PLFORM. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

list

Required. A previously created COLLECTION or loaded PLFORM variable into which the object is inserted.

object

Required. An object or COLLECTION definition that is inserted into the COLLECTION or PLFORM.

Flags Affected: NONE

Note the following:

1. If {list} is a PLFORM variable, a FORMLOAD instruction reinitializes the variable.

2. Multiple objects or a COLLECTION may be specified in the LISTINS statement.

3. If a COLLECTION is inserted, nesting occurs. That is, the result is a COLLECTION within a COLLECTION.

4. If {object} already exists in the {list}, it is not added.

5. COLLECTIONS may not contain an IMAGELIST, STATUSPANEL, TOOLBUTTON, or MENUITEM object.

See Also: Example Code, LISTDEL, Object Instructions