4D v14.3

FIXER PARAMETRE ELEMENT

Accueil

 
4D v14.3
FIXER PARAMETRE ELEMENT

FIXER PARAMETRE ELEMENT 


 

FIXER PARAMETRE ELEMENT ( {* ;} liste ; refElément | * ; sélecteur ; valeur ) 
Paramètre Type   Description
Opérateur in 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 in 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 in 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 in Constante de paramètre
valeur  Chaîne, Booléen, Entier long, Réel in Valeur de paramètre

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 AJOUTER A LISTE).
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 Texte supplémentaire (placée dans le thème “Listes hiérarchiques”) ou toute valeur personnalisée :

  • Texte supplémentaire : 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 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é.

 
PROPRIÉTÉS 

Produit : 4D
Thème : Listes hiérarchiques
Numéro : 986
Nom intl. : SET LIST ITEM PARAMETER

 
HISTORIQUE 

Créé : 4D v11 SQL

 
VOIR AUSSI  

LIRE PARAMETRE ELEMENT
LIRE PARAMETRE ELEMENT TABLEAUX

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v12.4)
4D - Langage ( 4D v11 SQL Release 6)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)