                        SHORT DOC FOR BPUPICK DEMO

To run, create a directory with all the BPUPICK.ARC files.  Make it current.
Set your DOS path to the directory where FOXPLUS exists and start foxbase.
Type DO DEMO at the dot prompt and all is revealed.


This demo has not been tested on a mono screen, but should still give you the 
basic idea.  

OK, its time for a do everything list'n'pick UDF.  Lets say your user must 
enter exact character data, like a vender name or number.  The user is lazy,
and really doesn't want to type in the full name, nor would it be correct if
he/she did.  Or perhaps he/she only knows the first few letters of the data.
This UDF will:

   -  Take the GET entry and compare it against any .dbf *expression*
   -  If there is only *one* matching record, or if the first few letters
      typed are unique to only one record, enter any .dbf *expression* back
      into the GET field
   -  If no matches or multiple matches found, display a list'N'pick window
      with a suggested close "softseek" match to start
   -  Stuff the GET field with the user's selection
   -  Allow up/down arrow functionality as in normal series of GETs; uparrow
      works even if entry not valid
   -  Allow/dissallow blank entries.  If blank entry entered where not 
      allowed, list pick window comes up at top of file
   -  Trap F1 for context-by-GET help your way
   -  SET CONFIRM on or off for the next GET

Active keys in the picking widow are:

      Return:  selects the record at arrow
        PgUp:  pages up and displays more records above window, if any
        PgDn:  as above, but below
          F1:  a help routine, if you modify the code just a bit
        Home:  top of window
         End:  bottom of window
     Uparrow:  moves arrow up, scrolls list if at top
     Dnarrow:  moves arrow down, scrolls list if at bottom
   Ctrl-Home:  moves list to top of file
    Ctrl-End:  moves list to bottem of file

Syntax: @x,y GET memvar PICTURE whatever VALID Bpupick(params)
        The 10 params are shown in the code

IMO, the code is a massive kludge!  But, it works.  Speed will be too slow on
anything less than an AT, and a fast AT or better is prefered.  I would hope
that Fox will look at it and realize adding a few features are in order.  

Suggestions for improvement are very welcome.

                                                     Bruce Palmer
