User Tools

Site Tools


next_get_the_next_browse_item_.htm
Navigation:  ABC Library Reference > BrowseClass > BrowseClass Methods >====== Next (get the next browse item) C6H0009.jpg ====== Previous pageReturn to chapter overviewNext page

Next( ), BYTE, VIRTUAL

blk2blue.jpg

The Next method gets the next record from the browse view and returns a value indicating its success or failure.

Next returns Level:Benign if successful, Level:Notify if it reached the end of the file, and Level:Fatal if it encountered a fatal error.

Implementation:

Corresponding return value EQUATEs are declared in ABERROR.INC. See Error Class for more information on these severity level EQUATEs.

Level:Benign                  EQUATE(0)

Level:User                    EQUATE(1)

Level:Program                 EQUATE(2)

Level:Fatal                   EQUATE(3)

Level:Cancel                  EQUATE(4)

Level:Notify                  EQUATE(5)

The Next method is called by the Fetch and ResetThumbLimits(PRIVATE) methods. Among other things, Next calls the PARENT.Next (ViewManager.Next) method. See ViewManager for more information.

Return Data Type:     BYTE

Example:

CASE MyBrowse.Next()              !get next record

OF Level:Benign                   !if successful, continue

OF Level:Fatal                    !if fatal error

 RETURN                           ! end this procedure

OF Level:Notify                   !if end of file reached

 MESSAGE('Reached end of file.')  ! acknowledge EOF

END

See Also:     Fetch,

next_get_the_next_browse_item_.htm.txt · Last modified: 2021/04/15 15:57 by 127.0.0.1