Previous (RecordsetCursor function): Difference between revisions
Jump to navigation
Jump to search
m (Created page with "<span class="pageSubtitle"><section begin=dpl_desc/><section end=dpl_desc/></span> Previous function <p> <var>Previous</var> is a member of t...") |
(No difference)
|
Revision as of 18:19, 22 April 2011
<section begin=dpl_desc/><section end=dpl_desc/>
Previous is a member of the 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
[%cstate =] %rscursor: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.