4D v14.3

INSERT IN LIST

Home

 
4D v14.3
INSERT IN LIST

INSERT IN LIST 


 

INSERT IN LIST ( {* ;} Liste ; VorEintragRef | * ; NeuerText ; EintragRef {; Unterliste ; Erweitert} ) 
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 *)
VorEintragRef | *  Lange Ganzzahl, Operator in Referenznummer oder 0 für den zuletzt hinzugefügten Eintrag oder * für den aktuellen Eintrag der Liste
NeuerText  String in Text für neuen Listeneintrag
EintragRef  Lange Ganzzahl in Einmalige Referenznummer für neuen Listeneintrag
Unterliste  ListRef in Optionale Unterliste für neuen Listeneintrag
Erweitert  Boolean in Gibt an, ob die Unterliste auf- oder zugeklappt ist.

Der Befehl INSERT IN LIST fügt einen neuen Eintrag in die Liste mit der in Liste übergebenen Referenznummer oder dem Objektnamen ein.

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

Mit dem Parameter VorEintragRef können Sie den Eintrag bestimmen, vor dem der neue Eintrag eingefügt werden soll:

  • Übergeben Sie den Wert 0 (Null), um den zuletzt in der Liste hinzugefügten Eintrag zu bestimmen. Der neu eingefügte Eintrag wird dann zum ausgewählten Eintrag.
  • Übergeben Sie *, wird der Eintrag vor dem aktuell ausgewählen Eintrag in der Liste eingefügt. In diesem Fall wird der neu eingefügte Eintrag auch zum ausgewählten Eintrag.
  • Wollen Sie hingegen einen Eintrag vor einem bestimmten Eintrag einfügen, übergeben Sie dessen Referenznummer. In diesem Fall wird der neu eingefügte Eintrag nicht automatisch ausgewählt. Gibt es keinen Eintrag mit dieser Referenznummer, hat der Befehl keine Auswirkung.

In NeuerText und EintragRef übergeben Sie Text und Referenznummer des neuen Eintrags.

Hinweis: Wollen Sie dem Eintrag Untereinträge zuordnen, müssen Sie im Parameter Unterliste eine gültige Listenreferenz übergeben. In diesem Fall müssen Sie auch den Parameter Erweitert übergeben. Übergeben Sie hier Wahr oder Falsch, um die Unterliste entweder auf- oder zugeklappt anzuzeigen.

Folgender Code fügt einen Eintrag (ohne angehängte Unterliste) vor dem aktuell ausgewählten Eintrag in die Liste hList ein:

 vlUniqueRef:=vlUniqueRef+1
 INSERT IN LIST(hList;*;"New Item";vlUniqueRef)

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Hierarchische Listen
Nummer: 625

 
GESCHICHTE 

Geändert: 4D v11 SQL

 
SIEHE AUCH 

APPEND TO LIST

 
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)