LISTBOX SET COLUMN FORMULA
LISTBOX SET COLUMN FORMULA ( {* ;} object ; formula ; dataType )
| Parameter | Type | Description | |
|---|---|---|---|
| * | Operator | → | If specified, object is an object name (string)If omitted, object is a variable |
| object | any | → | Object Name (if * is specified) or Variable (if * is omitted) |
| formula | Text | → | 4D formula associated with column |
| dataType | Integer | → | Type of formula result |
This command is not thread-safe, it cannot be used in preemptive code.
Description
The LISTBOX SET COLUMN FORMULA command modifies the formula associated with the column of the list box designated by the object and * parameters. Formulas can only be used when the “Data Source” property of the list box is either Current Selection, Named Selection, or Collection or Entity Selection.
Note: You can use the OBJECT SET DATA SOURCE command to define the data source of an array type list box.
If you pass the optional * parameter, this indicates that the object parameter is an object name (a string). If you do not pass this parameter, this indicates that the object is a variable. In this case, you pass a variable reference instead of a string. This parameter must designate a list box column.
The formula parameter can contain any valid expression, i.e.:
- an instruction,
- a formula generated using the formula editor,
- a call to a 4D command,
- a call to a project method.
When the command is called, the formula is parsed and then executed.
Note: Use the Command name command to specify formulas independent from the application language (when they call 4D commands).
The dataType parameter designates the type of data resulting from the execution of the formula. In this parameter, you pass one of the constants from the Field and Variable Types theme. If the formula result does not match the expected data type, an error is generated.