setfillcolor

454—Appendix B. Command Reference

The color_arg specifies the color to be applied to the text in the cells. The color may be specified using predefined color names, or by specifying the individual red-green-blue (RGB) components using the special “@RGB” function. The latter method is obviously more difficult, but allows you to use custom colors.

The predefined colors are given by the keywords (with their RGB equivalents):

Examples

To set a purple background color for the cell in the second row and third column of TAB1, you may use any of the following:

tab1.setfillcolor(C2) @rgb(128, 0, 128)

456—Appendix B. Command Reference

Examples

tab1.setfont(B3:D10) "Times New Roman" +i

sets the font to Times New Roman Italic for the cells defined by the rectangle from B3 (row 3, column 2) to D10 (row 10, column 4).

tab1.setfont(3,B,10,D) 8pt

changes all of text in the region to 8 point.

tab1.setfont(4,B) +b -i

removes the italic, and adds boldface to the B4 cell (row 4, column 2).

The commands:

tab1.setfont(b) -s +u 14pt

tab1.setfont(2) "Batang" 14pt +u

modify the fonts for the column B, and row 2, respectively. The first command changes the point size to 14, removes strikethrough and adds underscoring. The second changes the typeface to Batang, and adds underscoring,

Cross-references

For additional discussion of tables see Chapter 4, “Working with Tables”.

See settextcolor (p. 467) and setfillcolor (p. 453) for details on changing the text and cell background colors. See setformat (p. 456) for setting the cell formats.

Set the display format for cells in object spreadsheet and table views.

Syntax

setformat—457

where format_arg is a set of arguments used to specify format settings. If necessary, you should enclose the format_arg in double quotes.

The cell_range option is used to describe the columns to be updated in groups and the cells to be modified in tables. For all other objects, setformat operates on all of the cells in the object.

For groups, the col_range may take one of the following forms:

For tables, the cell_range may take one of the following forms:

first_cell[:]last_cell, Top left cell of the selection range (specified in “cell” for- first_cell[,]last_cell mat), followed by bottom right cell of the selection range

(specified in “cell” format), separated by a “:” or “,” (e.g., “A2:C10”, “A2,C10”, or “R2C1:R10C3”, “R2C1,R10C3”). Apply to all cells in the rectangular region defined by the first cell and last cell.

458—Appendix B. Command Reference

To format numeric values, you should use one of the following format specifications:

In order to set a format that groups digits into thousands, place a “t” after a specified format. For example, to obtain a fixed number of decimal places, with commas used to separate thousands, use “ft[.precision]”. To obtain a fixed number of characters with a period used to separate thousands, use “ct[..precision]”.

If you wish to display negative numbers surrounded by parentheses (i.e., display the number -37.2 as “(37.2)”), then you should enclose the format string in “()” (e.g., “f(.8)”).

To format numeric values using date and time formats, you may use a subset of the possible date format strings (see “Date Formats” on page 132). The possible format arguments, along with an example of the date number 730856.944793113 (January 7, 2002 10:40:30.125 p.m) formatted using the argument are given by:

460—Appendix B. Command Reference

Note that the “hh” formats display 24-hour time without leading zeros. In our examples above, there is no difference between the “HH” and “hh” formats for 10 p.m.

Also note that all of the “YYYY” formats above may be displayed using two-digit year “YY” format.

Examples

To set the format for a series or a matrix object to fixed 5-digit precision, simply provide the format specification:

ser1.setformat f.5

matrix1.setformat f.5

For groups, provide the column identifier and format. The commands:

group1.setformat(2) f(.7)

group1.setformat(c) e.5

set the formats for the second and third series in the group.

You may use any of the date formats given above:

ser2.setformat YYYYMon

group1(d).setformat "YYYY-MM-DD HH:MI:SS.SSS"

to set the series display characteristics.

For tables, you must provide a valid cell specification:

tab1.setformat(B2) hh:MI:SS.SSS

tab1.setformat(2,B,10,D) g(.3)

tab1.setformat(R2C2:R4C4) "dd/MM/YY HH:MI:SS.SSS"

Cross-references

For additional discussion of tables see Chapter 4, “Working with Tables”.

See also setfont (p. 455), settextcolor (p. 467) and setfillcolor (p. 453) for details on changing the text font and text and cell background colors.