Member variable XbpBrowse():skipBlock Foundation

Code block that calls a routine moving the record pointer

Attribute: EXPORTED
Data type: Code block

This instance variable contains a code block which is used to move the record pointer of the data source. It initiates skip operations necessary for navigation. An XbpBrowse object evaluates this code block during stabilization. Two arguments are passed to the code block: the first is a numeric value which represents the number of skip operations and the direction in which the record pointer should be moved within the data source. A positive value indicates that the movement should be toward the end of the data source. A negative value indicates that the movement should be toward the beginning of the data source. The second argument passed to the code block is a reference to the XbpBrowse object itself. The code block must return the number of records it actually skipped. If the number returned is different from the number requested, this indicates that either the end of the table or begininng of the table was reached.

Typically, when using an XbpBrowse object to browse data in a work area, :skipBlock should be set to {|n| DBSkipper(n) }. DBSkipper() will be called and the XbpBrowse object will pass the number of rows it is requesting this function to skip. It then performs the skip operations and returns the number of records actually skipped.


If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.