State (RecordsetCursor function)
Return current state of RecordSetCursor (RecordsetCursor class)
This read-only method returns the current state of the cursor.
Syntax
%cursorState = recordsetCursor:State
Syntax terms
| %cstate | If specified, a declared enumeration object of type CursorState to contain the returned value of State. Possible values are BeforeStart, HasRecord, AfterEnd, NoRecord, and Empty, as described in "Cursor state". |
|---|---|
| %rscursor | An instantiated RecordsetCursor object. |
Example
The following fragment suggests a way to use the State property with a cursor object:
%rs is object recordSet in file myfile %srecs is object SortedRecordset in file myfile %myCursor is object RecordsetCursor in file myfile ... fd to %rs end find ... sort records in %rs to %srecs by name ... %myCursor = %srecs:Cursor fr in %srecs ... repeat while ( %myCursor:State = hasrecord ) end for ...