Previous (RecordsetCursor function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
mNo edit summary
Line 1: Line 1:
{{Template:RecordsetCursor:Previous subtitle}}
{{Template:RecordsetCursor:Previous subtitle}}
This [[Notation conventions for methods#Callable methods|callable]]
This [[Notation conventions for methods#Callable methods|callable]]
method positions the cursor on the “previous” record
method returns a <var>CursorState</var> enumeration
in the set, and it returns a <var>CursorState</var> enumeration
indicating the state of the cursor after it is moved.
indicating the state of the cursor after the operation.
==Syntax==
==Syntax==
{{Template:RecordsetCursor:Previous syntax}}
{{Template:RecordsetCursor:Previous syntax}}

Revision as of 00:11, 27 April 2011

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 &mdash; Advances to the previous record (if there is one).
    • AfterEnd &mdash; 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 &mdash; The cursor moved to a new record, and it is ready to go.
    • BeforeStart &mdash; The cursor ran off the beginning, and it points to no record.

See also