Please enable JavaScript to view this site.

ESL Documentation

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.