4D v14.3

GET LIST ITEM

Home

 
4D v14.3
GET LIST ITEM

GET LIST ITEM 


 

GET LIST ITEM ( {* ;} Liste ; EintragPos | * ; EintragRef ; NeuerText {; Unterliste ; Erweitert} ) 
Parameter Typ   Beschreibung
Operator in Mit * ist Liste ein Objektname (string).
Ohne * ist Liste eine Listenreferenznummer
Liste  ListRef, String in Ohne *: Referenznummer der Liste
Mit *: Objektname der Liste
EintragPos | *  Operator, Lange Ganzzahl in Stelle des Eintrags in auf-/zugeklappten Listen oder * für aktuellen Eintrag der Liste
EintragRef  Lange Ganzzahl in Referenznummer des Eintrags
NeuerText  String in Text des Eintrags
Unterliste  ListRef in Referenznummer der Unterliste
Erweitert  Boolean in Ist eine Unterliste zugeordnet: TRUE = Unterliste ist gerade erweitert, FALSE = Unterliste ist gerade geschlossen

Der Befehl GET LIST ITEM gibt Informationen zum Eintrag, angegeben in EintragPos in der Liste mit Referenznummer oder Objektname, übergeben in Liste.

Ü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. GET LIST ITEM wird aber nur auf das erste Objekt mit dem passenden Namen angewandt.

Die Position richtet sich nach dem aktuellen Status erweitert/geschlossen der Liste und den dazugehörigen Unterlisten. Die Position muss zwischen 1 und dem von Count list items zurückgebenen Wert liegen. Liegt er außerhalb dieses Bereichs, gibt GET LIST ITEM leere Werte zurück, also 0 (Null), "", o.ä..

Nach dem Aufruf finden Sie:

Mit den optionalen Parametern Unterliste und Erweitert:

  • Gibt Unterliste die Referenznummer der zugeordneten Unterliste zurück. Hat der Eintrag keine Unterliste, gibt Unterliste Null (0) zurück.
  • Hat der Eintrag eine Unterliste, gibt Erweitert TRUE zurück, wenn sie erweitert ist, FALSE, wenn sie geschlossen ist.

hList hat Einträge mit einmaligen Referenznummern. Folgender Code wechselt per Programmierung den Status erweitert/geschlossen der Unterliste, sofern sie vorhanden ist und dem aktuell ausgewählten Eintrag zugeordnet wurde:

 $vlItemPos:=Selected list items(hList)
 If($vlItemPos>0)
    GET LIST ITEM(hList;$vlItemPos;$vlItemRef;$vsItemText;$hSublist;$vbExpanded)
    If(Is a list($hSublist))
       SET LIST ITEM(hList;$vlItemRef;$vsItemText;$vlItemRef;$hSublist;Not($vbExpanded))
    End if
 End if

Siehe Beispiel zum Befehl APPEND TO LIST.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Hierarchische Listen
Nummer: 378

 
GESCHICHTE 

Geändert: 4D v11 SQL

 
SIEHE AUCH 

GET LIST ITEM PROPERTIES
List item parent
List item position
Selected list items
SET LIST ITEM
SET LIST ITEM PROPERTIES

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)