
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper 5.2 . The Guide To CA-Clippe - <b>browse()*</b>
[<<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.
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.
See Also: DBEDIT()*
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson