New list

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 6.0


New list ListRef

ParameterTypeDescription
This command does not require any parameters
Function resultListRefList reference number

Description

New list creates a new, empty hierarchical list in memory and returns its unique list reference number.

WARNING: Hierarchical lists are held in memory. When you are finished with a hierarchical list, it is important to dispose of it and free the memory, using the command CLEAR LIST.

Several other commands allow you to create hierarchical lists:

Copy list duplicates a list from an existing list.

Load list creates a list by loading a Choice List created (manually or programmatically) in the Design enviornment List Editor.

BLOB to list creates a list from the contents of a BLOB in which a list was previously saved.

After you have created a hierarchical list using New list, you can:

Add items to that list, using the command APPEND TO LIST or INSERT LIST ITEM.

Delete items from that list, using the command DELETE LIST ITEM.

Example

See example for the command APPEND TO LIST.

See Also

APPEND TO LIST, BLOB to list, CLEAR LIST, Copy list, DELETE LIST ITEM, INSERT LIST ITEM, LIST TO BLOB, Load list.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next