table.go

Syntax table.go (dir, count)
Params dir is either "up" or "down," indicating the direction in which you wish to move the table cursor.

count is the number of rows to move the table cursor in the indicated direction.
Action Moves the table cursor in the target window in the direction indicated by dir, the number of rows contained in count.
Returns True if the move is successful, false if it is not.
Examples edit (@examples.funStuff.dancing);
table.go (up,3)

   » true

Table cursor is now on the first row of the table, "adventure." Try executing this line:

   » table.go (up,1)

Table cursor still on first row; can't move up past this row.

edit (@examples.table1);
edit (@examples.funStuff.chess);
target.set (@examples.table1);
table.go (down,3)

   » true

Notice that we used target.set to change the target of the verb's action to a table window.

edit (@root)
table.go (down, infinity)

   » true

Table cursor is now on the last row of the root table. See Notes.

Errors Using a value for dir which is valid in an outline but meaningless in a table (such as left or right) will return a result of false but no error message.

If there is no table open when you use this verb and no target has been set, Frontier returns an error message.
Notes If count is infinity, the cursor will be moved all the way up or down, and table.go will return true if any motion occurs.

If count is not infinity, attempting to move up past the top line or down past the bottom line in the table will result in a return value of false and will leave the table cursor in its original position.

This verb works on the target window. By default, the target window is the topmost window, but you can use target.set to change it.
See Also table.getCursor

table.goto

table.gotoAddress

table.gotoName

Discuss