Macro Language Reference > PIs > Tables > <?tbcbgc>
  
<?tbcbgc>
Description
The <?tbcbgc> command allows the setting of a background color for a cell, and can be used in two ways.
With the first form, a background property is set as one of a list of background properties, as follows:
Specify the total number of cell backgrounds using the num parameter (this will increase by one every time you add a new background property)
Define the number of the background color in the list of background colors via the bnum parameter
Set the details of the background color using the color and flags parameters.
This allows you to override a particular background color provided the new color is set as one of the total number of backgrounds.
The <?tbcbgc> command can also be used to override the background for the current cell without the need to specify any condition flags and will automatically override earlier <?tbcbgc> commands. in this case, use the syntax <?tbcbgc="color">.
this command can also be specified as <?tbcellbgcolor>.
 
Example 397. Set the cell background color for specific cells in a table
The command below will apply a background color to the cells at the top of the table
<?tbcbgc 1(1,"80%","?t")>
Whereas this command will apply a background color to cells that are not at the bottom of the table:
<?tbcbgc 1(1,"80%","~?b")>
The command below will apply the background color to a cell 3 columns across and 2 rows down from the top left corner of the table:
<?tbcbgc 1(1,"80%","x=3y=2")>
 
Example 398. Set multiple cell background colors for specific cells in a table
The command below will apply a background color to 3 specific cells in the table, each identified via individual location coordinates:
<?tbcbgc 3(1,"cyan,"x=1y=1") (2,"80%","x=3y=2") (3,
"magenta","x=5y=4")>
Syntax
<?tbcbgc num:n? bnum:n? color:c flags:s?>
num
The total number of cell backgrounds
bnum
The number of the background in the list of background properties
colour
The required background color of the cell, either in name format e.g. "red" or (r,g,b) format: must be defined in double quotes.
flags
The positioning of the background color
t
Top row
b
Bottom row
l
Leftmost column
r
Rightmost column
x
Column number for cell coordinates, e.g. x=3
y
Row number for cell coordinates, e.g. y=2
Must be defined in double quotes.