4D v16.3

SUPPRIMER LISTE

Accueil

 
4D v16.3
SUPPRIMER LISTE

SUPPRIMER LISTE 


 

SUPPRIMER LISTE ( liste {; *} ) 
Paramètre Type   Description
liste  RefListe in Numéro de référence de liste
in 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 SUPPRIMER LISTE 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 SUPPRIMER LISTE 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 INFORMATION ELEMENT avec l'élément parent pour obtenir le numéro de référence de la sous-liste.
2. Appelez CHANGER ELEMENT avec l'élément parent pour dissocier la sous-liste de l'élément de liste avant de l'effacer.
3. Appelez SUPPRIMER LISTE pour effacer la sous-liste dont vous avez obtenu le numéro de référence à l'aide de INFORMATION ELEMENT.

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 Liste existante pour effacer la liste uniquement si c'est nécessaire :

  ` Extrait de la sous-routine de nettoyage
 Si(Liste existante(hlList))
    SUPPRIMER LISTE(hlList;*)
 Fin de si

Reportez-vous à l'exemple de la fonction Charger liste.

Reportez-vous à l'exemple de la fonction BLOB vers liste.



Voir aussi  

BLOB vers liste
Charger liste
Nouvelle liste

 
PROPRIÉTÉS 

Produit : 4D
Thème : Listes hiérarchiques
Numéro : 377
Nom intl. : CLEAR LIST

 
HISTORIQUE 

Créé : 4D v6

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)