BROWSE Clauses Saved by PREFERENCE

ID: Q111315

The information in this article applies to:

Microsoft FoxPro for Windows, version 2.5b
Microsoft FoxPro for MS-DOS, version 2.5b
Microsoft FoxPro for Macintosh, version 2.5b

SUMMARY

The PREFERENCE clause of the BROWSE command is used to save certain attributes of a Browse window for later use. Some BROWSE clauses are saved by the PREFERENCE clause, others are not. This article explains which clauses are saved by the PREFERENCE clause and which are not.

MORE INFORMATION

The following BROWSE commands demonstrate clauses that are saved by the PREFERENCE clause:

   BROWSE FIELDS client_id,company PREF b1
   BROWSE FONT "Courier New",10 PREF b2
   BROWSE STYLE "I" PREF b3

   BROWSE FREEZE contact PREF b6
   BROWSE PARTITION 20 LEDIT PREF b8
   BROWSE PARTITION 20 REDIT PREF b9
   BROWSE LOCK 2 PREF b10
   BROWSE PARTITION 20 PREF b11
   BROWSE PARTITION 20 LPARTITION PREF b12
   BROWSE NOAPPEND PREF b13

   BROWSE NODELETE PREF b15

   BROWSE NOEDIT PREF b16
   BROWSE NOMODIFY PREF b17

   BROWSE PARTITION 20 NOLGRID PREF b18
   BROWSE NORGRID PREF b19
   BROWSE PARTITION 20 NOLINK PREF b20
   BROWSE NOMENU PREF b21
   BROWSE TITLE "Hello" PREF b29
   BROWSE VALID myudf() PREF b30
   BROWSE WHEN mywhen() PREF b33
   BROWSE WIDTH 2 PREF b34
   BROWSE WINDOW test PREF b35
   BROWSE IN WINDOW test PREF b36
   BROWSE COLOR SCHEME 3 PREF b37
   BROWSE FIELD client_id,company:R PREF b38
   BROWSE FIELD client_id,company:3 PREF b39
   BROWSE FIELD client_id,company:v=myudf() PREF b40
   BROWSE FIELD client_id,company:v=myudf():F PREF b41
   BROWSE FIELD client_id,company:v=myudf():F:E='Error' PREF b42
   BROWSE FIELD client_id,company:P='!!!!!!!' PREF b43
   BROWSE FIELD client_id,startbal:B=5,10 PREF b44
   BROWSE FIELD client_id,startbal:B=5,10:F PREF b45
   BROWSE FIELD client_id,startbal:H='Header' PREF b46
   BROWSE FIELD client_id,startbal:W=mywhen() PREF b47

The following BROWSE commands demonstrate clauses that are not saved by the PREFERENCE clause:

   BROWSE FOR client_id = "A8101" PREF b4
   BROWSE KEY "A8101" PREF b7
   BROWSE NOCLEAR PREF b14
   BROWSE NOOPTIMIZE PREF b22
   BROWSE NOREFRESH PREF b23
   BROWSE NORMAL PREF b24
   BROWSE NOWAIT PREF b25
   BROWSE SAVE PREF b27
   BROWSE TIMEOUT 3 PREF b28
   BROWSE VALID :F myudf() PREF b31
   BROWSE VALID :F myudf() ERROR "Error Here" PREF b32

Steps to Reproduce Behavior

The following code can be used to reproduce the behavior documented in this article.

* brtest.prg *****************************************************************

* This program creates a Browse window, saves the preference,   *
* and then issues BROWSE PREFERENCE <prefname> to verify        *
* whether or not the preference was saved. The user must        *
* pay close attention to the information that appears in        *

* a WAIT WINDOW before each BROWSE variation, take any required *

* action, and then compare the BROWSE PREFERENCE results.       *

***************************************************************** * Run Instructions: * DO browpref IN brtest * Use Ctrl + W or Esc to exit each BROWSE window. * Press Esc repeatedly to terminate the program.

PROCEDURE browpref

ON KEY LABEL F10 RETURN TO browpref ON KEY LABEL F2 DO varswap

mgood = .T.

SET RESO OFF IF !FILE("myres.dbf")

     USE SYS(2005) AGAIN
     COPY STRUCTURE TO myres

ENDIF CLOSE ALL SET RESOURCE TO myres CLEAR

DEFINE WINDOW test FROM 05,05 TO 20,40 TITLE "mytestwin" COLO r/w,b/r

CLOSE ALL

SET SAFETY OFF

CREATE TABLE clients (CLIENT_ID C(5),COMPANY C(35), ;

  CONTACT C(20),ADDRESS C(30),CITY C(15),STARTBAL N(5,2))