4D v13.4
New list
- 4D Language Reference
-
- Hierarchical Lists
-
- Managing Hierarchical Lists
- APPEND TO LIST
- CLEAR LIST
- Copy list
- Count list items
- DELETE FROM LIST
- Find in list
- GET LIST ITEM
- Get list item font
- GET LIST ITEM ICON
- GET LIST ITEM PARAMETER
- GET LIST ITEM PARAMETER ARRAYSNew
- GET LIST ITEM PROPERTIES
- GET LIST PROPERTIES
- INSERT IN LIST
- Is a list
- List item parent
- List item position
- LIST OF CHOICE LISTS
- Load list
- New list
- REDRAW LIST
- SAVE LIST
- SELECT LIST ITEMS BY POSITION
- SELECT LIST ITEMS BY REFERENCE
- Selected list items
- SET LIST ITEM
- SET LIST ITEM FONT
- SET LIST ITEM ICON
- SET LIST ITEM PARAMETER
- SET LIST ITEM PROPERTIES
- SET LIST PROPERTIES
- SORT LIST
New list
| New list -> Function result | ||||||||
| Parameter | Type | Description | ||||||
| Function result | ListRef |
|
List reference number | |||||
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 IN LIST.
- Delete items from that list, using the command DELETE FROM LIST.
See example for the command APPEND TO LIST.
Product: 4D
Theme: Hierarchical Lists
Number:
375
Created: 4D v6
APPEND TO LIST
BLOB to list
CLEAR LIST
Copy list
DELETE FROM LIST
INSERT IN LIST
LIST TO BLOB
Load list
