Result:-GotoRow - move the cursor to the given row
|
Calling Sequence
|
|
result:-GotoRow(offset, opts )
|
|
Parameters
|
|
result
|
-
|
Result module
|
offset
|
-
|
integer; the index of the row
|
opts
|
-
|
(optional) equation of the form relative=boolean
|
|
|
|
|
Description
|
|
•
|
GotoRow moves the row cursor maintained within result to the row indexed by offset. If offset is positive, then it is interpreted to be relative to the beginning of the table. GotoRow(1) is the first row, GotoRow(2) is the second, and so forth. If offset is negative, then it is interpreted to be relative to the last row of the table. GotoRow(-1) is the last row, GotoRow(-2) is the second to last row.
|
•
|
The index of the current row can be obtained by calling GetRowIndex.
|
•
|
GotoRow accepts one optional argument.
|
|
If relative is true, then offset is interpreted as relative to the current row. For example, GotoRow(1,relative=true) is equivalent to Next.
|
•
|
Setting the row cursor to a location beyond the ends of the table results in the cursor getting set to the row before the first data row or the row after the last data row.
|
|
|
Examples
|
|
Create a Result.
>
|
|
>
|
|
Notice the order of names.
>
|
|
| (1) |
Go to the last row.
>
|
|
| (2) |
>
|
|
| (3) |
Go to the first row.
>
|
|
| (4) |
>
|
|
| (5) |
Go to the second row.
>
|
|
| (6) |
>
|
|
| (7) |
Go to the second to last row.
>
|
|
| (8) |
>
|
|
| (9) |
Go to the third to last row (absolute index of 8).
>
|
|
| (10) |
>
|
|
| (11) |
Go to the fourth row (8-4=4).
>
|
|
| (12) |
>
|
|
| (13) |
Go to the sixth row (4+2=6).
>
|
|
| (14) |
>
|
|
| (15) |
>
|
|
| (16) |
>
|
|
| (17) |
|
|
Download Help Document
Was this information helpful?