setlines

466—Appendix B. Command Reference

tab1.setlines(2,b) -l -r +i

then removes both the left and the right border from the cell. In this example, “+i” option has no effect; since the specification involves a single cell, there are no inner borders.

tab1.setlines(@all) -a

removes all borders from the table.

Cross-references

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

See also settextcolor (p. 467) for details on setting cell colors. See setmerge (p. 466) for cell merging, and comment (p. 247) for adding comments to cells.

where cell_range describes the table cells (in a single row) to be merged. The cell_range specifications are given by:

first_cell[:]last_cell, Left (right) cell of the selection range (specified in “cell” first_cell[,]last_cell format), followed by right (left) cell of the selection

range (specified in “cell” format), separated by a “:” or “,” (e.g., “A2:C2”, “A2,C2”, or “R2C1:R2C3”, “R2C1,R2C3”). Merge all cells in the region defined by the first column and last column for the specified row.

If the first specified column is less than the last specified column (left specified before right), the cells in the row will be merged left to right, otherwise, the cells will be merged from right to left.The contents of the merged cell will be taken from the first non-empty cell in the merged region. If merging from left to right, the leftmost cell contents will be used; if merging from right to left, the rightmost cell contents will be displayed.

settextcolor—467

If you specify a merge involving previously merged cells, EViews will unmerge all cells within the specified range.

Examples

tab1.setmerge(a2:d2)

tab1.setmerge(2,1,2,4)

merges the cells in row 2, columns 1 to 4, from left to right.

tab2.setmerge(r2c5:r2c2)

merges the cells in row 2, columns 2 to 5, from right to left. We may then unmerge cells by issuing the command using any of the previously merged cells:

tab2.setmerge(r2c4:r2c4)

unmerges the previously merged cells.

Note that in all cases, the setmerge command must be specified using cells in a single row. The command:

tab3.setmerge(r2c1:r3c5)

generates an error since the cell specification involves rows 2 and 3.

Cross-references

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

See also setlines (p. 465).

Changes the text color of the specified table cells.

Syntax

where cell_range describes the table cells to be modified, and color_arg specifies the color to be applied to the text in the cells. See setfillcolor (p. 453) for the syntax for cell_range and color_arg.

Examples

To set an orange text color for the cell in the second row and sixth column of TAB1, you may use:

468—Appendix B. Command Reference

tab1.settextcolor(f2) @rgb(255, 128, 0)

tab1.settextcolor(2,f) @RGB(255, 128, 0)

tab1.settextcolor(2,6) orange

tab1.settextcolor(r2c6) orange

You may also specify a blue color for the text in an entire column, or an entire row,

tab1.settextcolor(C) @RGB(0, 0, 255)

tab1.settextcolor(2) blue

or a green color for the text in cells in a rectangular region:

tab1.settextcolor(R2C3:R3C6) green

tab1.settextcolor(r2c3,r3c6) green

tab1.settextcolor(2,C,3,F) @rgb(0, 255, 0)

tab1.settextcolor(2,3,3,6) @rgb(0, 255, 0)

Cross-references

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

See setfont (p. 455)and setfillcolor (p. 453) for details on changing the text font and cell background color.

Set the column width for selected columns in an object spreadsheet.

Syntax

where col_range is either a single column number or letter (e.g., “5”, “E”), a colon delimited range of columns (from low to high, e.g., “3:5”, “C:E”), or the keyword “@ALL”, and width_arg specifies the width unit value, The width unit is computed from representative characters in the default font for the current table (the EViews table default font at the time the table was created), and corresponds roughly to a single character. width_arg values may be non-integer values with resolution up to 1/10 of a width unit.

Examples

tab1.setwidth(2) 12

sets the width of column 2 to 12 width units.