User Tools

Site Tools


next_get_the_next_element_.htm
Navigation:  ABC Library Reference > ViewManager > ViewManager Methods >====== Next (get the next element) C6H0009.jpg ====== Previous pageReturn to chapter overviewNext page

Next, VIRTUAL

blk2blue.jpg

The Next method gets the next VIEW element, subject to the applied sort order, range limit, and filter, and returns a value indicating its success or failure.

If Next succeeds, it returns Level:Benign (declared in ABERROR.INC). If it fails, it returns Level:Notify or Level:Fatal depending on the error encountered. See Error Class for more information on severity levels.

Implementation:

The Next method uses the ValidateRecord method to validate records that are not filtered out.

Return Data Type:     BYTE

Example:

CASE MyView.Next()                !try to get the next record

OF Level:Benign                   !& check for success

 !process the record

OF Level:Notify                   !& check for failure

 !write error log

OF Level:Fatal                    !& check for fatality

 POST(Event:CloseWindow)

 BREAK

END

See Also:     ValidateRecord

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