List item parent

Version 11 (Geändert)

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

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.

In der Anwendungsumgebung gibt es die Liste hList:

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

• 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.

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

Anwendung des Befehls

Open 4D Preferences, XSLT Office 2003

---