4D v16.3

Count list items

Home

 
4D v16.3
Count list items

Count list items 


 

Count list items ( {* ;} Liste {; *} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
Operator in Mit * ist Liste ein Objektname (String).
Ohne * ist Liste eine Listenreferenznummer
Liste  ListRef, String in Referenznummer der Liste (ohne *) oder Objektname der Liste (mit *)
Operator in Ohne * (Standard): Gibt sichtbare Einträge zurück (erweitert).
Mit *: Gibt alle Listeneinträge zurück
Funktionsergebnis  Lange Ganzzahl in Ohne 2ten *: Anzahl der sichtbaren (erweiterten) Listeneinträge.
Mit 2tem *: Gesamtzahl der Listeneinträge

Die Funktion Count list items gibt entweder die Anzahl der aktuell "sichtbaren" oder alle Einträge in der Liste mit der in Liste übergebenen Referenznummer oder dem Objektnamen zurück.

Übergeben Sie den ersten optionalen Parameter *, ist der Parameter Liste der Objektname (String) der Darstellung einer Liste im Formular. Geben Sie diesen Parameter nicht an, ist Liste die Referenznummer einer hierarchischen Liste (ListRef). Verwenden Sie nur eine einzige Darstellung der Liste oder arbeiten mit Strukturzeilen (der zweite * ist nicht übergeben), können Sie beide Arten verwenden. Verwenden Sie dagegen mehrere Darstellungen derselben Liste und arbeiten mit der aktellen Zeile (der zweite * ist übergeben), müssen Sie die Syntax mit dem Objektnamen verwenden, da jede Darstellung eine eigene aktuelle Zeile haben kann.

Hinweis: Verwenden Sie das Zeichen @ im Namen der Liste, erhalten Sie einen Satz Objekte im Formular, zu denen der Name passt. Count list items wird aber nur auf das erste Objekt mit dem passenden Namen angewandt.

Mit dem zweiten Parameter * gibt die Funktion alle Einträge in der Liste zurück, egal ob diese auf- oder zugeklappt ist.
Ohne den Parameter * gibt Count list items nur die Anzahl der Einträge zurück, die je nach Erweiterung der Liste und der dazugehörigen Unterlisten sichtbar sind.

Wenden Sie diese Funktion auf eine Liste in einem Formular an.

In der Anwendungsumgebung gibt es die Liste hList:

 $vlNbItems:=Count list items(hList) ` $vlNbItems erhält 8
 $vlNbItems:=Count list items(hList;*) ` $vlNbItems erhält ebenfalls 8

 $vlNbItems:=Count list items(hList) ` $vlNbItems erhält hier 2
 $vlNbItems:=Count list items(hList;*) ` $vlNbItems erhält weiterhin 8

 $vlNbItems:=Count list items(hList) ` $vlNbItems erhält hier 5
 $vlNbItems:=Count list items(hList;*) ` $vlNbItems erhält weiterhin 8



Siehe auch 

List item position
Selected list items

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Hierarchische Listen
Nummer: 380

 
GESCHICHTE 

Geändert: 4D v11 SQL

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)