The following table lists terms that are useful when describing certain runtime attributes of tables. We include them here because they are important to understand when programming for tables and to indicate the action statements and built-in functions that affect them. Note that these terms are not part of the ESL language. Use the built-in functions and action statements described elsewhere in this chapter to manipulate these attributes.
Term |
Description |
Query Using |
Modify Using |
Current cell |
The current location in the table; the cell that will be edited when edit mode is enabled. Also called the table cursor. |
xcursor,ycursor |
change cursor |
Formatted cell value |
The actual text of a numeric or boolean column that is displayed in the table. This is affected by the current contents of the cell and the column formatting string. For example, if "-5.2" was entered, it might be displayed as "($5.20)". |
N/A |
Modify by changing the cell contents or column format |
Response cell, row, or column |
The part of the table on which the user acted to cause a response. xcoord is the horizontal position of the column or cell, or 0 if the response is for a row header. ycoord is the vertical position of the row or cell, or 0 if the response is for a column header. |
xcoord, ycoord |
N/A |
Selection |
The rows or columns selected. The table definition determines if selection is allowed and if, multiple selection is allowed for rows and for columns. |
is selected, selected columns of selected rows of |
select, deselect |
Window position |
The cell displayed in the upper left-hand corner of the table's window This changes whenever the table is scrolled. |
window xposition of, windowyposition of |
change window position |
Window size |
The number of fully displayed rows and columns in the table's window. This depends on the current size of the window, the font size, and the width of the columns displayed. Thus, the horizontal window size can change as other columns are scrolled into view, because their width is different |
window xsize of, window ysize of |
change size, change column width. |