FIXER PARAMETRE ELEMENT

4D v20 R7


FIXER PARAMETRE ELEMENT ( {* ;} 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, Réel	Valeur de paramètre

Description

La commande FIXER PARAMETRE ELEMENT 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.

Dans le paramètre sélecteur, vous pouvez passer :

une des constantes suivantes du thème "Listes hiérarchiques" :

Constante	Type	Valeur	Comment
Associer action standard	Chaîne	4D_standard_action_name	Associe une action standard à l'élément refElément. Dans ce cas, vous devez passer dans le paramètre valeur un nom d'action standard avec un paramètre, par exemple "fontSize?value=10pt". Pour plus d'informations, veuillez vous reporter à la section Actions standard dans le manuel Mode Développement.
Texte supplémentaire	Chaîne	4D_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.

ou une valeur personnalisée : 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 LIRE PARAMETRE ELEMENT. 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é.

Exemple

Vous souhaitez définir comme énumération d'un pop up menu hiérarchique une liste personnalisée de valeurs de tailles de police, à l'aide de la fonctionnalité des actions standard :

 $myList:=Nouvelle liste

 AJOUTER A LISTE($myList;ak standard action title;1)

 AJOUTER A LISTE($myList;ak standard action title;2)

 AJOUTER A LISTE($myList;ak standard action title;3)

 FIXER PARAMETRE ELEMENT($myList;1;Associer action standard;"fontSize?value=10pt")

 FIXER PARAMETRE ELEMENT($myList;2;Associer action standard;"fontSize?value=12pt")

 FIXER PARAMETRE ELEMENT($myList;3;Associer action standard;"fontSize?value=14pt")

 OBJET FIXER LISTE PAR REFERENCE(*;"popup";Liste énumération;$myList)

Voir aussi

AJOUTER A LISTE
INSERER DANS LISTE
Lire info action
LIRE PARAMETRE ELEMENT
LIRE PARAMETRE ELEMENT TABLEAUX