version 2003 (Modifiée)
SUPPRIMER ELEMENT (liste; réfElément | *{; *})
Paramètre | Type | Description | |
liste | RéfListe | Numéro de référence de liste | |
réfElément | * | Entier long | * | Numéro de référence d'élément ou | |
0 pour le dernier élément ajouté à la liste ou | |||
* pour l'élément de la liste actuellement sélectionné | |||
* | Si spécifié, effacer les sous-listes de la mémoire (le cas | ||
échéant) | |||
Si omis, ne pas effacer les sous-listes |
Description
La commande SUPPRIMER ELEMENT supprime l'élément désigné par le paramètre réfElément de la liste dont le numéro de référence est passé dans liste.
Si vous passez * dans réfElément, vous supprimez l'élément actuellement sélectionné de la liste. Vous pouvez également passer 0 dans ce paramètre afin de demander la suppression du dernier élément ajouté à la liste.
Sinon, vous spécifiez le numéro de référence de l'élément à supprimer. Si le numéro ne correspond à aucun élément de la liste, la commande ne fait rien.
Si vous travaillez avec les numéros de référence des éléments, veillez à construire une liste dans laquelle les éléments ont des numéros de référence uniques, sinon vous ne pourrez les différencier. Pour plus d'informations sur ce point, reportez-vous à la description de la commande AJOUTER A LISTE.
Quel que soit l'élément que vous supprimez, vous pouvez passer un troisième paramètre optionnel, *, pour indiquer à 4D de supprimer automatiquement de la mémoire la sous-liste rattachée à l'élément, s'il en existe. Si vous ne passez pas ce paramètre, il est préférable de récupérer au préalable le numéro de référence de la sous-liste (éventuelle) rattachée à l'élément, de manière à pouvoir si besoin est supprimer cette sous-liste à l'aide de la commande SUPPRIMER LISTE.
Exemple
L'exemple suivant supprime l'élément sélectionné de la liste hList. Si une sous-liste est rattachée à l'élément, elle est supprimée (ainsi que toute sous-sous-liste) :
SUPPRIMER ELEMENT(hList;*;*) REDESSINER LISTE(hList) ` N'oubliez pas d'appeler REDESSINER LISTE sinon la liste n'est pas mise à jour
Référence
INFORMATION ELEMENT, SUPPRIMER LISTE.