Product Documentation
Virtuoso Layout Suite SKILL Reference
Product Version IC23.1, November 2023

xfgrSetCellProps

xfgrSetCellProps( 
t_tableName
x_rowNumber
t_colName
[ ?enable {t|nil} ]
[ ?value t_value ]
[ ?bgColor t_bgColor ]
[ ?textColor t_color ]
) 
=> t / nil

Description

Sets properties of a cell of a table. The valid properties are enable, value, bgColor, and textColor. You can use this function from the xFGR Create form customization callback functions.

Arguments

t_tableName

The name of the table.

x_rowNumber

Row number of the table.

t_colName

Name of a column of the table.

?enable {t|nil}

Enable or disable a cell. Valid values are:

  • t: Enables a cell of the table.
  • nil: Disables a cell of the table.

?value t_value

Value of a cell of the table.

?bgColor t_bgcolor

Background color of a cell of the table.

?textColor t_color

Color of the text in a cell of the table.

Value Returned

t

The properties of a cell are set.

nil

The properties of a cell are not set.

Example

Sets properties of a cell of a table. 

procedure(tableValueChanged(tableName row colName value prevValue)
    when(tableName == "myTable"
    xfgrSetCellProps("myTable" row colName ?enable t ?textColor "red" ?bgColor             "white")
 )
 )
;;xFGR Create Form customization callback. It is triggered when cell is updated.
    xfgrTableCellValueChangedCB("r" "tableValueChanged")

Return to top
 ⠀
X