4D v14.3

LISTBOX INSERT COLUMN FORMULA

Home

 
4D v14.3
LISTBOX INSERT COLUMN FORMULA

LISTBOX INSERT COLUMN FORMULA 


 

LISTBOX INSERT COLUMN FORMULA ( {* ;} Objekt ; SpaltePosition ; SpalteName ; Formel ; Datentyp ; KopfName ; KopfVar {; FußName ; FußVar} )  
Parameter Typ   Beschreibung
Operator in Mit * ist Objekt ein Objektname (String),
ohne * ist Objekt eine Variable
Objekt  Formularobjekt in Objektname (mit *) oder Variable (ohne *)
SpaltePosition  Lange Ganzzahl in Position der einzufügenden Spalte
SpalteName  String in Name des Objekts Spalte
Formel  String in Der Spalte zugeordnete 4D Formel
Datentyp  Lange Ganzzahl in Typ des Formelergebnisses
KopfName  String in Objektname des Spaltenkopfteils
KopfVar  Variable Ganzzahl in Variable des Spaltenkopfteils
FußName  String in Objektname des Spaltenfußteils
FußVar  Variable in Variable des Spaltenfußteils

Der Befehl LISTBOX INSERT COLUMN FORMULA fügt eine Spalte in eine Listbox ein, definiert durch die Parameter Objekt und *.
Der Befehl arbeitet ähnlich wie der Befehl LISTBOX INSERT 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 SpaltePosition. Ist die Nummer von SpaltePosition größer als die Gesamtanzahl der Spalten, wird sie an die letzte Spalte angefügt.

In SpalteName übergeben Sie den Objektnamen der eingefügten Spalte.

Der Parameter Formel kann einen beliebigen gültigen Ausdruck enthalten, 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 ausgefü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 bestimmen, die nach Ausführen der Formel zurückgegeben wird. Sie müssen eine der folgenden Konstanten unter dem Thema Feld und Variablentypen übergeben:

Konstante Typ Wert
Is Boolean Lange Ganzzahl 6
Is date Lange Ganzzahl 4
Is picture Lange Ganzzahl 3
Is real Lange Ganzzahl 1
Is text Lange Ganzzahl 2
Is time Lange Ganzzahl 11

Entspricht das Ergebnis der Formel keinem der erwarteten Datentypen, wird ein Fehler erzeugt.

In den Parametern KopfName und KopfVar übergeben Sie den Objektnamen und die Variable des eingefügten Kopfteils der Spalte.

In den Parametern FußName und FußVar können Sie auch den Objektnamen und die Variable für den Fußteil der eingefügten Spalte übergeben. Lassen Sie den Parameter FußVar weg, verwendet 4D eine dynamische Variable.

Hinweis: Objektnamen müssen in einem Formular einmalig sein. Sie müssen sicherstellen, dass die in SpalteName, KopfName und FußName übergebenen Namen nicht anderweitig verwendet werden. Ansonsten wird die Spalte nicht erstellt und ein Fehler erzeugt.

Wir wollen rechts vor der Listbox eine neue Spalte hinzufügen mit einer Formel, die das Alter der Angestellten berechnet:

 vAge:="Current date-[Employees]BirthDate)\365"
 $last:=LISTBOX Get number of columns(*;"ListBox1")+1
 LISTBOX INSERT COLUMN FORMULA(*;"ListBox1";$last;"ColFormula";vAge;Is real;"Age";HeaderVar)

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Listbox
Nummer: 970

 
GESCHICHTE 

Erstellt: 4D v11 SQL
Umbenannt: 4D v12
Geändert: 4D v13

 
SIEHE AUCH 

LISTBOX INSERT COLUMN

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)

Geerbt von : LISTBOX INSERT COLUMN FORMULA ( 4D v12.4)
Gesplittet : LISTBOX INSERT COLUMN FORMULA ( 4D v14 R3)