4D v16.3

List item parent

Home

 
4D v16.3
List item parent

List item parent 


 

List item parent ( {* ;} Liste ; EintragRef | * ) -> 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 *)
EintragRef | *  Operator, Lange Ganzzahl in Referenznummer des Eintrags oder 0 für zuletzt hinzugefügten Eintrag oder * für aktuellen Eintrag in der Liste
Funktionsergebnis  Lange Ganzzahl in Referenznummer des übergeordneten Eintrags 0, wenn kein Eintrag existiert

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.

In der Anwendungsumgebung gibt es die Liste hList:

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

EintragReferenznummer
a100
a - 1101
a - 2102
b200
b - 1201
b - 2202
b - 3203
  • 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.



Siehe auch 

GET LIST ITEM
List item position
SELECT LIST ITEMS BY REFERENCE
SET LIST ITEM

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Hierarchische Listen
Nummer: 633

 
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)