[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
go()
Position cursor at a specific physical identity (record)
------------------------------------------------------------------------------
Prototype
ERRCODE go(
AREAP wa,
ULONG row
)
Arguments
wa is a pointer to self.
row is the row number of the new cursor position.
Description
go() repositions the work area cursor for wa to the physical row number row.
Default Behavior
You must implement the default behavior of this method through a
subclass.
Implementation Notes
. Since go() repositions the pointer to a physical row number,
you need not consider active scopes or filters. If the row is not in
the physical range of rows available, you may generate an error or
position the pointer at the physical end of file.
. In CA-Clipper, the idea of a phantom row is vital to the
performance of certain functions. The go() method should permit
access to the phantom row. The phantom row is defined as the last
row + 1 and is the position at which end of file is set to TRUE. All
columns of the phantom row are empty. A row value greater than the
last row in the table should position the pointer to the phantom row.
If you do not support the concept of the phantom row in your driver,
you must document this fact as an incompatibility of your driver with
the high-level CA-Clipper syntax.
Files Header file is Rdd.api.
See Also:
AREA
goBottom()
goTop()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson