Click above to get retro games delivered to your door ever month!

 BROWSE()*
 Browse records within a window
------------------------------------------------------------------------------
 Syntax

     BROWSE([<nTop>], [<nLeft>],
        [<nBottom>], [<nRight>]) --> lSuccess

 Arguments

     <nTop>, <nLeft>, <nBottom>, and <nRight> define the
     window coordinates.  If not specified, the default window coordinates
     are 1, 0 to MAXROW(), and MAXCOL().

 Returns

     BROWSE() returns false (.F.) if there is no database file in use;
     otherwise, it returns true (.T.).

 Description

     BROWSE() is a user interface function that invokes a general purpose
     table-oriented browser and editor for records in the current work area.
     For a list of the navigation keys which are used by BROWSE(), refer to
     the DBEDIT() function.

 Notes

     .  Status line: BROWSE() supports a status line in the upper
        right corner of the browse window indicating one of the following:

        BROWSE() Status Line Messages
        ---------------------------------------------------------------------
        Message   Meaning
        ---------------------------------------------------------------------
        <new>     Append mode
        <bof>     Top of file
        <delete>  Current record is deleted
        Record    Record number display
        ---------------------------------------------------------------------

     .  BROWSE() has the following three modes:

        -  Browsing: This is the default mode of BROWSE().  Pressing
           any DBEDIT() navigation key moves the highlight to a new column or
           row.

        -  Field edit: Pressing Return on any field enters field edit
           using a GET.  Pressing Return terminates the edit mode, saving the
           changes.  Esc terminates without saving changes.  Since the field
           edit mode uses GET, all navigation and editing keys are READ keys.

        -  Append: GOing BOTTOM with Ctrl-PgDn and then pressing
           Dnarrow enters append mode with the indicating message "<new>" on
           the status line.  A new blank record is then inserted.  Pressing
           Uparrow terminates the append mode, saving the new record if data
           has been entered.  If no data has been entered, the new record is
           not saved.

 Examples

     .  This is an example of browsing a file:

        USE File1 NEW
        BROWSE()

 Files:  Library is EXTEND.LIB, source file is SOURCE\SAMPLE\BROWSE.PRG.