4D v16.3
CLEAR LIST
- 4D - Langage
-
- Listes hiérarchiques
-
- Gestion des listes hiérarchiques
- 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
CLEAR LIST
| CLEAR LIST ( liste {; *} ) | ||||||||
| Paramètre | Type | Description | ||||||
| liste | RefListe |
|
Numéro de référence de liste | |||||
| * |
|
Si spécifié, effacer les sous-listes de la mémoire (s'il existe des sous-listes) Si omis, ne pas effacer les sous-listes | ||||||
La commande CLEAR LIST efface de la mémoire la liste hiérarchique dont vous avez passé le numéro de référence dans le paramètre liste.
Généralement, vous devez passer le paramètre optionnel *, afin que les sous-listes et les sous-éléments (s'il y en a) rattachés à la liste soient également effacés.
Il n'est pas nécessaire de supprimer une liste associée à un objet de formulaire via la Liste des propriétés : 4D charge et efface la liste automatiquement. Sinon, à chaque fois que vous chargez, copiez, extrayez d'un BLOB ou créez une liste par programmation, appelez la commande CLEAR LIST lorsque vous n'en avez plus besoin.
Si vous voulez supprimer une sous-liste rattachée à un élément (à tout niveau) d'une autre liste affichée dans un formulaire, procédez de la manière suivante :
1. Appelez GET LIST ITEM avec l'élément parent pour obtenir le numéro de référence de la sous-liste.
2. Appelez SET LIST ITEM avec l'élément parent pour dissocier la sous-liste de l'élément de liste avant de l'effacer.
3. Appelez CLEAR LIST pour effacer la sous-liste dont vous avez obtenu le numéro de référence à l'aide de GET LIST ITEM.
Vous disposez, dans votre application, d'une routine de "nettoyage" chargée d'effacer tous les objets et données dont vous n'avez plus besoin lorsque, par exemple, une fenêtre ou un formulaire est refermé(e). A un endroit de cette routine, vous supprimez une liste hiérarchique qui peut avoir déjà été supprimée, suivant les actions de l'utilisateur dans le formulaire. Vous utilisez la fonction Is a list pour effacer la liste uniquement si c'est nécessaire :
` Extrait de la sous-routine de nettoyage
If(Is a list(hlList))
CLEAR LIST(hlList;*)
End ifReportez-vous à l'exemple de la fonction Load list.
Reportez-vous à l'exemple de la fonction BLOB to list.
Produit : 4D
Thème : Listes hiérarchiques
Numéro :
377
Créé : 4D v6
4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)
