4D v16.3
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 ARRAYS
- 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
- 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
- _o_REDRAW 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 APPEND TO LIST command.
APPEND TO LIST
BLOB to list
CLEAR LIST
Copy list
DELETE FROM LIST
INSERT IN LIST
LIST TO BLOB
Load list
Product: 4D
Theme: Hierarchical Lists
Number:
375
Created: 4D v6
4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)
