Version 11
INSERT LISTBOX COLUMN FORMULA ({*; }Objekt; SpaPosition; SpaName; Formel; Datentyp; KopfteilName; KopfteilVar)
Parameter | Typ | Beschreibung | |
* | * | Mit * ist Objekt eine >Objektname (String) | |
Ohne * ist Objekt eine Variable | |||
Objekt | Formularobjekt | Objektname (mit *) | |
oder Variable (ohne * ) | |||
SpaPosition | Zahl | Position der einzufügenden Spalte | |
SpaName | String | Name des Objekts Spalte | |
Formel | String | Der Spalte zugeordnete 4D Formel | |
Datentyp | Lange Ganzzahl | Typ des Formelergebnisses | |
KopfteilName | String | Name des Objekts Kopfteil Spalte | |
KopfteilVar | Variable Zahl | Variable der Kopfteil Spalte |
Beschreibung
Der Befehl INSERT LISTBOX COLUMN FORMULA fügt eine Spalte in eine Listbox ein, definiert durch die Parameter Objekt und *.
Der Befehl arbeitet ähnlich wie der Befehl INSERT LISTBOX COLUMN. Der Unterschied ist, dass Sie damit auch eine Formel als Inhalt einer Spalte eingeben können. Eine Formel als Inhalt ist nur möglich, wenn die Eigenschaft Datenquelle" der Listbox auf Aktuelle oder Temporäre Auswahl gesetzt ist.
Weitere Informationen dazu finden Sie im Abschnitt Einführung in Listboxen.
Mit dem optionalen Parameter * ist der Parameter Objekt ein Objektname (String). Ohne * ist Objekt eine Variable. In diesem Fall übergeben Sie keinen String, sondern eine Variablenreferenz. Weitere Informationen zu Objektnamen finden Sie im Abschnitt Objekteigenschaften.
Die neue Spalte wird direkt vor der Spalte eingefügt, definiert durch den Parameter SpaPosition. Ist die Nummer von SpaPosition größer als die Gesamtanzahl der Spalten, wird sie an die letzte Spalte angefügt.
In SpaName übergeben Sie den Objektnamen der eingefügten Spalte.
Der Parameter Formel kann einen beliebigen gültigen Ausdruck enthal-ten, z.B.:
Eine Anweisung
Eine Formel, die über den Formulareditor erstellt wurde,
Aufruf eines 4D Befehls,
Aufruf einer Projektmethode.
Bei Aufruf des Befehls wird die Formel durchlaufen und dann ausge-führt.
Hinweis: Um Formeln unabhängig von der Anwendungssprache zu definieren, verwenden Sie die Funktion Command name (wenn Sie 4D Befehle aufrufen).
Mit dem Parameter Datentyp können Sie den Typ der Daten bestim-men, die nach Ausführen der Formel zurückgegeben wird. Sie müssen eine der folgenden Konstanten aus dem Thema "Feld- und Variablen-typen" übergeben:
Konstante | Typ | Wert |
Is Real | Lange Ganzzahl | 1 |
Is Text | Lange Ganzzahl | 2 |
Is Picture | Lange Ganzzahl | 3 |
Is Date | Lange Ganzzahl | 4 |
Is Boolean | Lange Ganzzahl | 6 |
Is Time | Lange Ganzzahl | 11 |
Entspricht das Ergebnis der Formel keinem der erwarteten Datentypen, wird ein Fehler erzeugt.
In den Parametern KopfteilName und KopfteilVar übergeben Sie den Objektnamen und die Variable des eingefügten Kopfteils der Spalte.
Hinweis: Objektnamen müssen in einem Formular einmalig sein. Sie müssen sicherstellen, dass die in SpaName und KopfteilName übergebenen Namen nicht anderweitig verwendet werden. Ansonsten wird die Spalte nicht erstellt und ein Fehler erzeugt.
Beispiel
Wir wollen am rechten Teil der Listbox eine neue Spalte hinzufügen mit einer Formel, die das Alter der Angestellten berechnet:
vAge:="Current date-[Employees]BirthDate)\365" $last:=Get number of listbox columns(*;"ListBox1")+1 INSERT LISTBOX COLUMN FORMULA(*;"ListBox1";$last;"ColFormula";vAge;Is Real;"Age";HeaderVar)
Referenz
New List Box Feature in 4Dv11SQL - Part 2