4D Doc Center : List item position

Home

4D v14.3

List item position


List item position ( {* ;} Liste ; EintragRef ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
*	Operator	Mit * ist Liste ein Objektname (String) Ohne * ist Liste eine Referenznummer
Liste	ListRef, String	Ohne : Referenznummer der Liste Mit : Objektname der Liste
EintragRef	Lange Ganzzahl	Referenznummer des Eintrags
Funktionsergebnis	Lange Ganzzahl	Stelle des Eintrags in auf-/zugeklappten Listen

Beschreibung

Die Funktion List item position gibt die Position des Eintrags mit der in EintragRef übergebenen Referenznummer 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. List item position wird aber nur auf das erste Objekt mit dem passenden Namen angewandt.

Hinweis: Im Gegensatz zu den anderen Funktionen dieses Kapitels können Sie dieser Funktion in EintragRef nicht den Wert 0 zuordnen, um den letzten Eintrag anzugeben.

Die Position richtet sich nach dem obersten Eintrag der Hauptliste und dem aktuellen Status erweitert bzw. geschlossen der Liste und deren Unterlisten. Demnach ist das Ergebnis eine Zahl zwischen 1 und dem in Count list items zurückgegebenen Wert. Liegt der Eintrag in einer geschlossenen Liste, erweitert List item position die entsprechende Liste und macht den Eintrag sichtbar. Existiert der Eintrag nicht, gibt List item position den Wert 0 zurück.