property Column.ComputedField as String

Retrieves or sets a value that indicates the formula of the computed column.

Type | Description | |||

String | A String expression that indicates the formula to compute the field/cell. The formula is applied to all cells in the column with the CellValueFormat property on exText ( the exText value is by default ). |

A computed field or cell displays the result of an
arithmetic formula that may include operators, variables and constants. By
default, the ComputedField property is empty. If the the ComputedField
property is empty, the property have no effect. If the ComputedField property
is not empty, all cells in the column, that have the CellValueFormat
property on exText, uses the same formula to display their content. For
instance, you can use the CellValueFormat property on exHTML, for cells in the
column, that need to display other things than column's formula, or you can
use the CellValueFormat property on exComputedField, to change the formula for
a particular cell. Use the FormatColumn
property to format the column.

Use the CellValueFormat property to change the type for a particular cell. Use the CellValue property to specify the cell's content. For instance, if the CellValueFormat property is exComputedField, the Caption property indicates the formula to compute the cell's content.

The Def(exCellValueFormat) property is changed to exComputedField, each time the ComputeField property is changed to a not empty value. If the ComputedField property is set to an empty string, the Def(exCellValueFormat) property is set to exText. Call the Refresh method to force refreshing the control.

The expression may be a combination of variables, constants, strings, dates and operators. A string is delimited by ", ` or ' characters, and inside they can have the starting character preceded by \ character, ie "\"This is a quote\"". A date is delimited by # character, ie #1/31/2001 10:00# means the January 31th, 2001, 10:00 AM.

Samples:

- "
**1**", the cell displays 1 - "
**%0 + %1**", the cell displays the sum between cells in the first and second columns. - "
**%0 + %1 - %2**", the cell displays the sum between cells in the first and second columns minus the third column. - "
**(%0 + %1)*0.19**", the cell displays the sum between cells in the first and second columns multiplied with 0.19. - "
**(%0 + %1 + %2)/3**", the cell displays the arithmetic average for the first three columns. - "
**%0 + %1 < %2 + %3**", displays 1 if the sum between cells in the first two columns is less than the sum of third and forth columns. - "
**proper(%0)**'" formats the cells by capitalizing first letter in each word - "
**currency(%1)**'" displays the second column as currency using the format in the control panel for money - "
**len(%0) ? currency(dbl(%0)) : ''**" displays the currency only for not empty/blank cells. - "
**int(date(%1)-date(%2)) + 'D ' + round(24*(date(%1)-date(%2) - floor(date(%1)-date(%2)))) + 'H''**" displays interval between two dates in days and hours, as xD yH **"2:=((1:=int(0:= date(%1)-date(%0))) = 0 ? '' : str(=:1) + ' day(s)') + ( 3:=round(24*(=:0-floor(=:0))) ? (len(=:2) ? ' and ' : '') + =:3 + ' hour(s)' : '' )"**displays the interval between two dates, as x day(s) [and y hour(s)], where the x indicates the number of days, and y the number of hours. The hour part is missing, if 0 hours is displayed, or nothing is displayed if dates are identical.

*The expression supports cell's identifiers as follows:*

**%0**,**%1**,**%2**,**%C0**,**%C1**,**%C2**,**%CD0**,**%CD1**,**%CD2**,**%CS0**,**%CS1**,**%CS2**,

This property/method supports predefined constants and operators/functions as described here.