4D v16.3

Nombre elements

Accueil

 
4D v16.3
Nombre elements

Nombre elements 


 

Nombre elements ( {* ;} liste {; *} ) -> 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é)
Opérateur in Si omis (défaut) : Retourner les éléments visibles (déployés) dans la ou les liste(s) Si spécifié : Retourner tous les éléments
Résultat  Entier long in Nombre d'éléments visibles (déployés) si 2e * omis ou Nombre total d’éléments si 2e * passé

La fonction Nombre elements retourne soit le nombre d'éléments visibles soit le nombre total d'éléments dans la liste dont vous avez passé le numéro de référence ou le nom d'objet dans 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 tous les éléments (le second * est passé), 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 les éléments visibles (le second * est omis), 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 Nombre elements s'appliquera au premier objet dont le nom correspond.

Le choix du type d'information à retourner est effectué à l'aide du second paramètre *. Lorsque ce paramètre est passé, la commande retourne le nombre total d’éléments présents dans la liste, quel que soit son état courant déployé/contracté.
Lorsque ce paramètre est omis, la commande retourne le nombre d'éléments qui sont visibles, en fonction de l'état déployé/contracté actuel de la liste et de ses sous-listes.

Cette fonction doit être appliquée à une liste affichée dans un formulaire.

Voici la liste hList affichée en mode Application :

 $vlNbItems:=Nombre elements(hList) ` à ce stade, $vlNbItems vaut 8
 $vlNbTItems:=Nombre elements(hList;*) `$vlNbTItems vaut également 8

 $vlNbItems:=Nombre elements(hList) ` à ce stade, $vlNbItems vaut 2
 $vlNbTItems:=Nombre elements(hList;*) `$vlNbTItems vaut toujours 8

 $vlNbItems:=Nombre elements(hList) `$vlNbItems vaut 5
 $vlNbTItems:=Nombre elements(hList;*) `$vlNbTItems vaut toujours 8



Voir aussi  

Elements selectionnes
Position element liste

 
PROPRIÉTÉS 

Produit : 4D
Thème : Listes hiérarchiques
Numéro : 380
Nom intl. : Count list items

 
HISTORIQUE 

Modifié : 4D v11 SQL

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)