SET LIST ITEM PARAMETER

4D v16.3


SET LIST ITEM PARAMETER ( {* ;} liste ; refElément \| * ; sélecteur ; valeur )

Paramètre	Type	Description
*	Opérateur	Si spécifié, liste est un nom d’objet (chaîne) Si omis, liste est un numéro de référence de liste
liste	RefListe, Chaîne	Numéro de référence de liste (si * omis) ou Nom d'objet de type liste (si * passé)
refElément \| *	Opérateur, 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 courant de la liste
sélecteur	Chaîne	Constante de paramètre
valeur	Chaîne, Booléen, Entier long, Réel	Valeur de paramètre

Description

La commande SET LIST ITEM PARAMETER permet de modifier le paramètre sélecteur pour l’élément réfElément de la liste hiérarchique dont vous avez passé la référence ou le nom d’objet dans le paramètre liste.

Si vous passez le premier paramètre optionnel *, vous indiquez que le paramètre liste est un nom d’objet (chaîne) correspondant à une représentation de liste dans le formulaire. Si vous ne passez pas ce paramètre, vous indiquez que le paramètre liste est une référence de liste hiérarchique (RéfListe). Si vous utilisez une seule représentation de liste ou travaillez avec les éléments structurels (le second * est omis), vous pouvez utiliser indifféremment l’une ou l’autre syntaxe. En revanche, si vous utilisez plusieurs représentations d’une même liste et travaillez avec l’élément courant (le second * est passé), la syntaxe basée sur le nom d’objet est requise car chaque représentation peut disposer de son propre élément courant.

Vous pouvez passer un numéro de référence dans réfElément. Si ce numéro ne correspond à aucun élément de la liste, la commande ne fait rien.Vous pouvez également passer 0 dans réfElément afin de demander la modification du dernier élément ajouté à la liste (à l’aide de Listes hiérarchiques).
Vous pouvez enfin passer * dans réfElément : dans ce cas, la commande s’appliquera à l’élément courant de la liste. Si plusieurs éléments sont sélectionnés manuellement, l’élément courant est celui qui a été sélectionné en dernier. Si aucun élément n’est sélectionné, la commande ne fait rien.

Vous pouvez passer dans sélecteur la constante Additional text (placée dans le thème “Listes hiérarchiques”) ou toute valeur personnalisée :

Additional text : cette constante permet d’ajouter un texte à droite de l’élément réfElément. Ce libellé supplémentaire reste toujours affiché dans la partie droite de la liste, même si l’utilisateur déplace le curseur de défilement horizontal. Lorsque vous utilisez cette constante, passez dans valeur le texte à afficher.
Sélecteur personnalisé : vous pouvez passer dans sélecteur tout texte personnalisé et lui associer une valeur de type texte, numérique ou booléen. Cette valeur sera stockée avec l’élément et pourra être récupérée via la commande GET LIST ITEM PARAMETER. Ce principe permet de mettre en place tout type d’interface associée aux listes hiérarchiques. Par exemple, dans une liste stockant des noms de personnes, vous pouvez stocker l’âge de chaque personne et ne l’afficher que lorsque l’élément correspondant est sélectionné.

Voir aussi

GET LIST ITEM PARAMETER
GET LIST ITEM PARAMETER ARRAYS