Previous (RecordsetCursor function)

From m204wiki
Revision as of 19:40, 14 July 2011 by JALWiccan (talk | contribs) (1 revision)
Jump to navigation Jump to search

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

This callable method returns a CursorState enumeration indicating the state of the cursor after it is moved.

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