4D Doc Center : List item parent

Home

4D v14.3

List item parent


List item parent ( {* ;} Liste ; EintragRef \| * ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
*	Operator	Mit * ist Liste ein Objektname (String) Ohne * ist Liste eine Listenreferenznummer
Liste	ListRef, String	Referenznummer der Liste (ohne ) oder Objektname der Liste (mit )
EintragRef \| *	Operator, Lange Ganzzahl	Referenznummer des Eintrags oder 0 für zuletzt hinzugefügten Eintrag oder * für aktuellen Eintrag in der Liste
Funktionsergebnis	Lange Ganzzahl	Referenznummer des übergeordneten Eintrags 0, wenn kein Eintrag existiert

Beschreibung

Die Funktion List item parent gibt die Referenznummer des übergeordneten Eintrags 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 parent wird aber nur auf das erste Objekt mit dem passenden Namen angewandt.

In Liste übergeben Sie die Referenznummer der Liste; in EintragRef die Referenznummer eines Eintrags der Liste oder *. Übergeben Sie den Wert 0 (Null), gilt die Funktion für den zuletzt in der Liste hinzugefügten Eintrag. Mit * bezieht sich die Funktion auf den aktuellen Eintrag der Liste. Wurden mehrere Einträge manuell ausgewählt, ist der zuletzt ausgewählte Eintrag der aktuelle.

Gehört dagegen der entsprechenden Eintrag in der Liste zu einer Unterliste, erhalten Sie die Referenznummer des übergeordneten Eintrags.

Existiert kein Eintrag mit der übergebenen Referenznummer oder Sie haben * übergeben und es ist kein Eintrag gewählt, oder es gibt keinen übergeordneten Eintrag, gibt List item parent den Wert 0 (Null) zurück.

Arbeiten Sie mit Referenznummern, sollten diese einmalig sein, damit Sie die Einträge unterscheiden können. Weitere Informationen dazu finden Sie in der Beschreibung zum Befehl APPEND TO LIST.

Beispiel

In der Anwendungsumgebung gibt es die Liste hList:

Die Referenznummern der Einträge werden folgendermaßen gesetzt:

Eintrag	Referenznummer
a	100
a - 1	101
a - 2	102
b	200
b - 1	201
b - 2	202
b - 3	203

Wählen Sie in folgendem Code den Eintrag “b - 3”, erhält die Variable $vlParentItemRef die Nummer 200, die Nummer für den übergeordneten Eintrag “b”:

 $vlItemPos:=Selected list items(hList)

 GET LIST ITEM(hList;$vlItemPos;$vlItemRef;$vsItemText)

 $vlParentItemRef:=List item parent(hList;$vlItemRef) ` $vlParentItemRef erhält 200

Wählen Sie “a - 1”, erhält die Variable $vlParentItemRef die Nummer 100, die Nummer für den übergeordneten Eintrag “a”.
Wählen Sie “a” oder “b”, erhält die Variable $vlParentItemRef die 0, da es für diese Einträge keine übergeordneten Einträge gibt.