List item parent

4D - Documentation   Français   English   German   Spanish   Japanese   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next

Version 11 (Geändert)


List item parent ({*; }Liste; EintragRef | *) Numerisch

ParameterTypBeschreibung
**Mit * ist Liste ein Objektname (String)
Ohne * ist Liste eine Listenreferenznummer
ListeListenRef | StringReferenznummer der Liste (ohne *), oder
Objektname der Liste (mit *)
EintragRef | *Lange Ganzzahl | *Referenznummer des Eintrags oder
0 für zuletzt hinzugefügten Eintrag oder
* für aktuellen Eintrag in der Liste
FunktionsergebnisNumerischReferenznummer 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 (ListenRef). 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.

Beispiele

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.

Referenz

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


4D - Documentation   Français   English   German   Spanish   Japanese   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next