The following table lists the ESL action statements that support table objects.
There are restrictions on column manipulation when there is data displayed in the table. In particular, you cannot insert, move, clear, or remove columns when the table contains more than 64 kilobytes of data. A table can contain more data than that, but, to do so, you must define the columns before adding that much data. The 64-kilobyte limitation only affects applications that dynamically modify a table while there is data in it. It is always possible to modify a table after clearing it. See the description of the column modifiability of built-in function.
Notes: If a row or column identifier is not a constant string, an integer, or a variable name, you must enclose it in parentheses. This is true even for built-in functions such as ycoord; for example:
cell Sales, (ycoord) of Table
Action Statement |
Effect |
activate |
Activate a table. |
add |
Create a new table at runtime. |
add to class |
Add a table to a class of objects. |
add to TABLE_NAME |
Add new rows or columns in a table, at runtime. |
change column delimiter |
Change the column delimiter used when converting rows to and from text strings and files. |
change column format |
Change the format string for a column. |
change column heading |
Change a column heading. |
change column position |
Move a column to another position in the same table. |
change column width |
Change the width of a column by or to some number of dialog units. |
change cursor |
Change the cell cursor to a different cell. |
change edit key |
Change the keystroke the user must press to start edit mode. |
change position |
Change the location of a table within its parent. |
change row delimiter |
Change the row delimiter used when converting rows to and from text strings or files. |
change row headings |
Change the width of row headings. |
width |
|
change row position |
Move a row to another position in the same table. |
change size |
Change the viewport and window size of the table. |
change window position |
Scroll the table to change the row and column shown in the upper left-hand corner. |
change window position to cursor |
Scroll the table, if necessary, so the current cell is displayed. |
clear |
Clear the data from the table or from one row, column, or cell in a table, but do not change their attributes. |
copy |
Copy values to/from a table row or cell. |
delete |
Delete a whole table. |
delete from class |
Remove a table from a class. |
deselect |
Deselect one or all rows and columns in a table. |
disable |
Disable a table so it cannot be activated by the user. |
enable |
Enable a table. |
find |
Find a text string in a table. |
for each row/column loop |
Perform actions for rows/columns in a table. |
make COLOR |
Change the background or foreground color of a table. |
make column editable/ readonly |
Make a column editable/readonly (allow/disallow users to directly edit cells in the column). |
make column grid visible/grid invisible |
Make the column grid lines (in)visible. |
make column invisible/visible |
Make a column (in)visible |
make column parameter |
Change the parameter string of a column. |
make column resizeable |
Make a column resizeable by the user or not. |
make edit/accept/cancel |
Start, end, or abort cell editing. |
make editable |
Allow users to edit cells directly. |
make helpid |
Change the helpid value. |
make invisible/ visible |
Make a whole table (in)visible. |
make parameter |
Change the value of a table's parameter string. |
make readonly |
Make a whole table read-only (users cannot directly edit cells). |
make resizeable |
Make all of the columns in a table directly resizeable or not. |
make row grid |
Make the row grid lines visible or invisible. |
visible/invisible |
|
read file |
Read a file and update rows in a table, starting at the current cell position. |
refresh |
Refresh the display of a table. |
remove |
Delete one or a range of rows or columns from a table. |
save program as |
Save the current status of each table in your ESL program, except for the data. |
select |
Select one or all rows or columns in a table. |
write |
Write every row in a table to a file. |