4D Doc Center : CLEAR LIST

Home

4D v14.3

CLEAR LIST


CLEAR LIST ( Liste {; *} )

Liste	ListRef	Referenznummer der Liste
*		Löscht evtl. vorhandene Unterlisten aus dem Speicher. Ohne Angabe werden evtl. vorhandene Unterlisten nicht gelöscht

Beschreibung

Der Befehl CLEAR LIST gibt hierarchische Listen mit der in Liste übergebenen Referenznummer frei.

Im Normalfall übergeben Sie den optionalen * Parameter, damit alle evtl. vorhandenen Unterlisten zu Einträgen oder Untereinträgen der Liste ebenfalls freigegeben werden.

Eine Liste, die einem Formularobjekt über das Fenster Objekteigenschaften zugeordnet wurde, lädt und löscht 4D automatisch. Sie benötigen dafür nicht den Befehl CLEAR LIST. Rufen Sie CLEAR LIST jedoch immer auf, wenn Sie eine Liste laden, kopieren, aus einem BLOB entnehmen oder per Programmierung erstellen und bearbeitet haben.

Wollen Sie eine Unterliste löschen, die einem Eintrag (auf beliebiger Ebene) einer anderen Liste im aktuell angezeigten Formular zugeordnet ist, gehen Sie folgendermaßen vor:

Wählen Sie GET LIST ITEM für den entsprechenden Eintrag, um die Referenz der Unterliste zu erhalten.
Wählen Sie SET LIST ITEM für den entsprechenden Eintrag, um die Unterliste vor dem Löschen vom Eintrag der Liste zu trennen.
Wählen Sie CLEAR LIST, um die Unterliste mit der über GET LIST ITEM erhaltenen Referenznummer zu löschen.

Beispiel 1

Sie haben eine sog. Aufräumroutine, die alle nicht länger benötigten Objekte und Daten löscht, z.B. wenn ein Fenster geschlossen und ein Formular aus dem Speicher entfernt wird. Unter Umständen löschen Sie erneut eine hierarchische Liste, die je nach Aktion des Benutzers im Formular bereits gelöscht wurde. Mit Is a list wird die Liste nur wenn erforderlich gelöscht:

  ` Auszug aus der Aufräumroutine

 If(Is a list(hlList))

    CLEAR LIST(hlList;*)

 End if

Beispiel 2

Siehe Beispiel zur Funktion Load list.

Beispiel 3

Siehe Beispiel zur Funktion BLOB to list.