CLEAR LIST

version 6.0

CLEAR LIST (list{; *})

The CLEAR LIST command deletes the hierarchical list whose list reference number you pass in list.

Usually you will pass the optional * parameter, so all the sublists, if any, attached to items or subitems of the list will be deleted as well.

You do not need to clear a list attached to a form object via the Property List window. 4D loads and clears the list for you. On the other hand, each time you load, copy, extract from a BLOB, or create a list programmatically, call CLEAR LIST when you are through with the list.

To clear a sublist attached to an item (on any level) of another list currently displayed in a form, proceed as follows:

1. Call GET LIST ITEM on the parent item to get the list reference of the sublist.

2. Call SET LIST ITEM on the parent item to detach the sublist from the list item before clearing it.

3. Call CLEAR LIST to clear the sublist whose reference number you obtained with GET LIST ITEM.

4. Call REDRAW LIST for the list displayed in the form, to recalculate its items and sublists.

1. Within a clean-up routine that clears all objects and data that you no longer need (i.e., when a window is closed and a form unloaded), you may end up clearing a hierarchical list that may have already been cleared, depending on the user actions within the form. Use Is a list to clear the list only if necessary:

      ` Extract of clean-up routine
   If (Is a list(hlList))
      CLEAR LIST(hlList;*)
   End if

2. See example for the Load list command.

3. See example for the BLOB to list command.

BLOB to list, Load list, New list.