[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 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.  Note that Browse() is a compatibility function.
     DBEDIT() should be used in its place.  For a more complicated BROWSE(),
     TBROWSE() should be used.

 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 Down
           arrow enters append mode with the indicating message "<new>" on
           the status line.  A new blank record is then inserted.  Pressing
           Up arrow 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


See Also: DBEDIT()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson