version 2003 (Modified)
List item position (list; itemRef) Number
Parameter | Type | Description | |
list | ListRef | List reference number | |
itemRef | Longint | Item reference number | |
Function result | Number | Item position in expanded lists |
Description
The List item position command returns the position of the item whose item reference number is passed in itemRef, within the list whose list reference number is passed in list.
Note: Unlike the other commands of this theme, with this command it is not possible to pass the value 0 in itemRef to designate the last item added.
The position is expressed relative to the top item of the main list, using the current expanded/collapsed state of the list and its sublist.
The result is therefore a number between 1 and the value returned by Count list items.
If the item is not visible because it is located in a collapsed list, List item position expands the appropriate list to make the item visible.
If the item does not exist, List item position returns 0.
See Also
Count list items, SELECT LIST ITEMS BY REFERENCE.