# Tables

A table is a two dimensional array of selectable text fields or “cells”. The table can be horizontally and vertically scrollable. All cells in the same column have the same width, but you can define the width of this column.

A table can have both column and row headers. A row of “column headers” is shown on top of the array of cells. This special row of cells will scroll horizontally with the rest of the table, but not vertically. “Row headers” are shown in a column to the left of the table. This column scrolls with the table only in the vertical direction.

You can navigate through a table using the left, right, up and down arrow keys. The program will be informed of cell selection whenever an arrow key is used to move to a different cell. You can tell the table to automatically add a new row of cells to its bottom whenever the user attempts to move past the last row using the “down arrow” key.

Using the “Edit/Properties” option you can set the following attributes:

Viewed width – The total width in font units of space occupied by the entire table (including row headers, and scroll bar).

Viewed height – The total height in font units of space occupied by the entire table (including column headers and scroll bar).

Number columns – Number of columns of cells (not including headers).

Number rows – Number of rows of cells (not including headers).

Column headers – If checked, the table will contain a separate row of column headers at the top of the cells.

Row headers – If checked, the table will contain a separate column of row headers on the left of the cells.

Automatic grow – If checked, the table will automatically add a row if the user attempts to move past the last row with the “down arrow” key.

The attributes of all columns in the table are shown within a separate “column detail” table.

Column (1,2,...) width – The number of characters that shown in the cells of a particular column. Select the cell in the column corresponding to the one you want to change, and type in a new width.

Column (1,2,...) alignment – Text in a table cell can be justified to the left or right, or can be centered. Within the “column detail” table (l=Left justified, c=Centered, and r=Right justified).

You can also set the initial contents of the cells in the table. A duplicate table of the one your working on will show the initial contents of all cells. To change the initial contents of a cell, select the corresponding cell in the “cell detail” table, then type in the new text.

See Also

Controls.