Previous (RecordsetCursor function)

From m204wiki
Jump to navigation Jump to search

Move cursor to the previous record in the set (RecordsetCursor class)


This callable method positions the cursor on the “previous” record in the set, and it returns a CursorState enumeration indicating the state of the cursor after the operation.

Syntax

[%cursorState =] recordsetCursor:Previous

Syntax terms

%cstate If specified, a declared enumeration object of type CursorState to contain the state of the cursor after the completion of Previous. Valid values are described in "Cursor state".
%rscursor An instantiated RecordsetCursor object.

Usage notes

  • Previous may be issued if the cursor is in one of two states:
    • HasRecord — Advances to the previous record (if there is one).
    • AfterEnd — Advances to the last record.
  • If Previous is called on a cursor whose state is BeforeStart, the request is cancelled.
  • After issuing Previous, the cursor is left in one of two states:
    • HasRecord — The cursor moved to a new record, and it is ready to go.
    • BeforeStart — The cursor ran off the beginning, and it points to no record.

See also