Skip to main content
Version: 9.0.2

gra.table.navigate

Navigates the cells of a table, sets the active cell which in turn generates the cell focus events.  If the new active cell is not visible the table will be scrolled in order to show this cell.

The action arguments are:

control The name of the table control to scroll. May be a comma separated list if multiple tables are specified.

fps The frames per second rate at which to scroll the table, 0 performs an immediate scroll.

duration The duration in milliseconds to run the scroll over, 0 scrolls it immediately.

direction The type of navigation to perform

set Sets the active row and column to what is specified in the row/col parameters. The option only ensures that the cell is visible and does not guarantee the cell will be at the top of the visible list.

next Move to the next cell, scroll by column then by row

prev Move to the previous cell, scroll by column then by row

up Move to the cell above the current one

down Move to the cell below the current one

left Move to the cell to the left of the current one

right Move to the cell to the right of the current one

home Move to the first cell in the table at row,column 1,1

end Move to the last cell in the table

row The row to navigate to. This is only used if direction is assigned set

col The column to navigate to. This is only used if direction is assigned set