Version 2004 (Geändert)
List item parent (Liste; EintragRef | *) Numerisch
Parameter | Typ | Beschreibung | |
Liste | ListenRef | Referenznummer der Liste | |
EintragRef | * | Lange GZ | * | Referenznummer des Eintrags oder | |
* für aktuellen Eintrag in der Liste | |||
Funktionsergebnis | Numerisch | Referenznummer des übergeordneten Eintrags | |
0 wenn kein Eintrag existiert |
Beschreibung
Die Funktion List item parent gibt die Referenznummer des übergeordneten Eintrags zurück.
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 Benutzerumgebung 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.
Referenz
GET LIST ITEM, List item position, SELECT LIST ITEMS BY REFERENCE, SET LIST ITEM.
Open 4D Preferences, XSLT Office 2003