List item parent

version 6.0

List item parent (list; itemRef) Number

Parameter	Type		Description
list	ListRef		List reference number
itemRef	Number		Item reference rumber
Function result	Number		Item reference number of parent item
			0 if none

The command List item parent returns the item reference number of a parent item.

You pass a list reference number in list; you pass the item reference number of an item of the list in itemRef. In return, if the item reference number refers to an existing item in the list and if this item is in a sublist (and therefore has a parent item), you obtain the item reference number of a parent item.

If there is no item with the item reference number you passed or if the item has no parent, List item parent returns 0 (zero).

If you work with item reference numbers, build a list in which the items have unique reference numbers, otherwise you will not be able to distinguish the items. For more information, see the description of the command APPEND TO LIST.

Given the list named hList shown here in the User environment:

The item reference numbers are set as follows:

Item	Item Reference Number
a	100
a - 1	101
a - 2	102
b	200
b - 1	201
b - 2	202
b - 3	203

• In the following code, if the item "b - 3" is selected, the variable $vlParentItemRef gets 200, the item reference number of the item "b":

   $vlItemPos:=Selected list item(hList)
   GET LIST ITEM(hList;$vlItemPos;$vlItemRef;$vsItemText)
   $vlParentItemRef:=List item parent(hList;$vlItemRef) ` $vlParentItemRef

• If the item "a - 1" is selected, the variable $vlParentItemRef gets 100, the item reference number of the item "a".

• If the item "a" or "b" is selected, the variable $vlParentItemRef gets 0, because these items have no parent item.

GET LIST ITEM, List item position, SELECT LIST ITEM BY REFERENCE, SET LIST ITEM.