4D v13.4
SORT 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
SORT LIST
| SORT LIST ( list {; > or <} ) | ||||||||
| Parameter | Type | Description | ||||||
| list | ListRef |
|
List reference number | |||||
| > or < | Operator |
|
Sorting order: > to sort in ascending order, or < to sort in descending order | |||||
The SORT LIST command sorts the list whose reference number is passed in list.
To sort in ascending order, pass >. To sort in descending order, pass <. If you omit the sorting order parameter, SORT LIST sorts in ascending order by default.
SORT LIST sorts all levels of the list; it first sorts the items of the list, then it sorts the items in each sublist (if any), and so on, through all the levels of the list. This is why you will usually apply SORT LIST to a list in a form. Sorting a sublist is of little interest because the order will be changed by a call to a higher level.
SORT LIST does not change the current list item nor the current expanded/collapsed state of the list and sublists. However, because the current item can be moved by the sorting operation, Selected list items may return a different position before and after the sort.
Given the list named hList, shown here in the Application environment:
After the execution of this code:
` Sort the list and it sublists in ascending order
SORT LIST(hList;>)The list looks like:
After the execution of this code:
` Sort the list and it sublists in descending order
SORT LIST(hList;<)The list looks like:
Product: 4D
Theme: Hierarchical Lists
Number:
391
Created: 4D v6
