4D Doc Center : LISTBOX INSERT COLUMN

4D v12.4

LISTBOX INSERT COLUMN


LISTBOX INSERT COLUMN ( {* ;} Objekt ; SpaltePos ; SpalteName ; SpalteVar ; KopfName ; KopfVar )

Parameter	Typ	Beschreibung
*		Mit : Objekt ist ein Objektname (String), Ohne : Objekt ist eine Variable
Objekt	Formularobjekt	Mit : Objektname, Ohne : Variable
SpaltePos	Lange Ganzzahl	Setzen der einzufügenden Spalte
SpalteName	String	Name des Spaltenobjekts
SpalteVar	Array, Feld, Variable	Name der Spalte des Array, Feldes oder der Variablen
KopfName	String	Name des Objekts Spaltentitel
KopfVar	Variable Ganzzahl	Variable des Spaltentitels

Beschreibung

Der Befehl LISTBOX INSERT COLUMN fügt eine Spalte in die Listbox ein, definiert durch Objekt und den Parameter *.

Mit dem optionalen Parameter * geben Sie an, dass Objekt ein Objektname (String) ist. Ohne diesen Parameter ist Objekt eine Variable. In diesem Fall übergeben Sie keinen String, sondern die Referenz auf eine Variable. Weitere Informationen zu Objektnamen finden Sie im Abschnitt Objekteigenschaften.
Die neue Spalte wird unmittelbar vor der Spalte eingefügt, die im Parameter SpaltePos angegeben ist. Ist SpaltePos größer als die Gesamtanzahl der Spalten, wird sie nach der letzten Spalte angefügt.

In SpalteName und SpalteVar übergeben Sie den Namen des Objekts und die Variable der eingefügten Spalte.

Bei einem Array vom Typ Listbox muss der Variablenname zum Namen des Array passen, dessen Inhalt in der Spalte angezeigt wird.
Bei einer Auswahl vom Typ Listbox müssen Sie in SpalteVar ein Datenfeld oder eine Variable übergeben. Der Inhalt der Spalte ist dann der Wert des Datenfeldes oder der Variablen, der für jeden Datensatz der der Listbox zugewiesenen Auswahl bewertet wird. Dieser Inhalt ist nur möglich, wenn die Eigenschaft "Datenquelle" der Listbox die aktuelle oder die temporäre Auswahl ist. Weitere Informationen dazu finden Sie im Abschnitt Einführung in Listboxen. Sie können Datenfelder oder Variablen vom Typ String, Zahl, Datum, Zeit, Bild und Boolean verwenden.

Bei Listboxen, die auf einer Auswahl basieren, können Sie über LISTBOX INSERT COLUMN einfache Elemente wie Datenfelder oder Variablen einfügen. Zur Verwaltung komplexer Ausdrücke, wie Formeln oder Methoden benötigen Sie den Befehl LISTBOX INSERT COLUMN FORMULA.

Hinweis: Sie können in derselben Listbox nicht Felder bzw. Ausdrücke und Arrays miteinander kombinieren.

In KopfName und KopfVar übergeben Sie den Objektnamen und die Variable für den eingefügten Spaltentitel.

Hinweis: Objektnamen müssen in einem Formular einmalig sein. Stellen Sie sicher, dass die in SpalteName und KopfName übergebenen Namen noch nicht verwendet wurden. Sonst wird die Spalte nicht erstellt und ein Fehler erscheint.

Beispiel 1

Folgender Code fügt am Ende der Listbox eine Spalte hinzu:

 C_LONGINT(HeaderVarName;$Last;RecNum)

 ALL RECORDS([Table 1])

 $RecNum:=Records in table([Table 1])

 ARRAY PICTURE(Picture;$RecNum)

 

 $Last:=LISTBOX Get number of columns(*;"ListBox1")+1

 LISTBOX INSERT COLUMN(*;"ListBox1";$Last;"ColumnPicture";Picture;

 "HeaderPicture";HeaderVarName)

Beispiel 2

Folgender Code fügt an die rechte Seite der Listbox eine Spalte hinzu und weist ihr die Werte aus dem Datenfeld [Transport]Fees zu

 $last:=LISTBOX Get number of columns(*;"ListBox1")+1

 LISTBOX INSERT COLUMN(*;"ListBox1";$last;"FieldCol";[Transport]Fees;"HeaderName";HeaderVar)