TXTextControl.TableCellFormula Property

Returns or sets the table cell's formula. For each table cell a formula can be defined which is used to calculate the cell's text. The formula can contain references to other table cells in the same table. When the text of a referenced cell changes, the cell which references it is automatically updated. The Supported Formula Functions section lists all supported formulas. Cell references can be specified either with the A1 or with the R1C1 notation. The A1 notation specifies a table cell with a column letter and a row number, for example B3 refers to the table cell in the third row and the second column. The R1C1 notation addresses a table cell with a row number and a column number, for example R2C3 refers to the same table cell in the third row and the second column. Relative addresses can be expressed with square brackets, for example R[-2]C[-3]. The numbers inside the square brackets show how many rows or columns the cell is relative to itself. Negative row numbers mean that the referenced cell is above the cell containing the formula. Negative column numbers mean that the referenced cell is to the left of the cell containing the formula. To switch the reference style the FormulaReferenceStyle property can be used. The formula's result is formatted according to the format specified with the TableCellNumberFormat property.

Introduced: 26.0.

Syntax

TXTextControl.TableCellFormula((TableId, Row, Column) [= string]
Parameter Description
TableId

Specifies a table. It is the same identifier set with the TableInsert method.

Row, Column

Specify a row and column number which identifies a certain cell in the table. The first has the number 1, 1.

Data Types

TableId:    Integer
Row:    Integer
Column:    Integer
Property value:    String

Limitations

Run time only.

See Also