INSERT LIST ITEM

Version 2003 (Geändert)

INSERT LIST ITEM (Liste; VorEintragRef | *; EintragText; EintragRef{; Unterliste{; Erweitert}})

Der Befehl INSERT LIST ITEM fügt einen neuen Eintrag in die Liste mit der in Liste übergebenen Referenznummer ein.

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 EintragText 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. Über geben 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 LIST ITEM(hList;*;"New Item";vlUniqueRef)
   REDRAW LIST(hList)

APPEND TO LIST.

Anwendung des Befehls

XML hierarchische Listen

---