4D v14.3

Position element liste

Accueil

 
4D v14.3
Position element liste

Position element liste 


 

Position element liste ( {* ;} liste ; réfElément ) -> Résultat 
Paramètre Type   Description
Opérateur in Si spécifié, liste est un nom d'objet (chaîne) Si omis, liste est une 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é)
réfElément  Entier long in Numéro de référence d'élément
Résultat  Entier long in Position de l'élément parmi la ou les liste(s) déployée(s)/contractée(s)

La commande Position element liste retourne la position de l'élément dont vous avez passé le numéro de référence dans réfElément parmi la liste dont vous avez passé le numéro de référence ou le nom d'objet dans liste.

Si vous passez le 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, vous pouvez utiliser indifféremment l’une ou l’autre syntaxe. En revanche, si vous utilisez plusieurs représentations d’une même liste, la syntaxe basée sur le nom d’objet est requise car chaque représentation peut disposer de sa propre configuration déployée/contractée.

Note : Si vous utilisez le caractère @ dans le nom d'objet de la liste et que le formulaire contient plusieurs listes répondant à ce nom, la commande Position element liste s'appliquera au premier objet dont le nom correspond.

Note : A la différence des autres commandes de ce thème, cette commande ne permet pas de passer la valeur 0 dans réfElément pour désigner le dernier élément ajouté.

La position est exprimée relativement à l'élément supérieur de la liste, en tenant compte de l'état déployé/contracté de la liste et de ses sous-listes.

Le résultat est donc compris entre 1 et la valeur retournée par Nombre elements.

Si l'élément n'est pas visible car il est inclus dans une liste contractée, Position element liste déploie la liste correspondante de manière à ce que l'élément devienne visible.

Si l'élément n'existe pas, Position element liste retourne 0.

 
PROPRIÉTÉS 

Produit : 4D
Thème : Listes hiérarchiques
Numéro : 629
Nom intl. : List item position

 
HISTORIQUE 

Modifié : 4D v11 SQL

 
VOIR AUSSI  

Nombre elements
SELECTIONNER ELEMENTS PAR REFERENCE

 
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)