4D Doc Center : Nombre elements

4D v14.3

Nombre elements


Nombre elements ( {* ;} liste {; *} ) -> Résultat

Paramètre	Type	Description
*	Opérateur	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	Numéro de référence de liste (si * omis) ou Nom d'objet de type liste (si * passé)
*	Opérateur	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	Nombre d'éléments visibles (déployés) si 2e * omis ou Nombre total d’éléments si 2e * passé

Description

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.

Exemples

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