home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / code_examples / pfiler / user.doc < prev    next >
Text File  |  1990-10-29  |  4KB  |  89 lines
  1.  
  2.  
  3.                               PFiler
  4.                        -------------------
  5.                        1990 by Preben Nielsen.
  6.                        Oehlenschlægersgade 72 St. T.V.
  7.                        1663 Copenhagen V. (Denmark).
  8.  
  9.                        PFiler is 100% Public Domain.
  10.  
  11.  
  12.     PFiler is a file-selector, which you can linked onto your own
  13.   programs (See PFilerDemo and Prog.Doc for more detail).
  14.  
  15.   This selector is:
  16.   a). Dynamic; it allocates the needed memory while
  17.       scanning a directory.
  18.   b). Asynchronous; you can select files, change directories, exit,
  19.       scroll through the file list etc., while the selector is scanning
  20.       a directory or sorting (Sorting is actually done while scanning).
  21.       
  22.  
  23.     When the selector opens its window, it will look something like this:
  24.  
  25.                  ---------------------------------------
  26.                 | Select a file                         |
  27.                 |---------------------------------------|
  28.                 | File1                        230  --  |
  29.                 | File2                      62637 |  | |
  30.                 | File3                         23 |  | |
  31.                 | File4                     129456 |  | |
  32.                 | (dir) Dir1                       |  | |
  33.                 | (dir) Dir2                       |  | |
  34.                 | (dir) Dir3                       |  | |
  35.                 |        ________________________  |__| |
  36.                 | Path  |                        | |  | |
  37.                 |       |------------------------| |--| |
  38.                 | File  |________________________| |__| |
  39.                 |                                       |
  40.                 |     Ok         Parent       Cancel    |
  41.                 |_______________________________________|
  42.  
  43.     The Title and and the text in the 'Ok' and 'Cancel' gadgets
  44.   can be changed by the calling program. The calling program also
  45.   decides whether or not the selector should include '.info' files
  46.   in the list.
  47.  
  48.  The window contains:
  49.  
  50.    o  The area where names are shown and can be selected by clicking
  51.       on them.
  52.  
  53.    o  A 'Path' string-gadget where you can enter the path you want.
  54.  
  55.    o  A 'File' string-gadget where you can enter the file you want.
  56.  
  57.    o  A proportional gadget for fast scrolling through the names.
  58.  
  59.    o  Two arrow gadgets for slow scrolling through the names.
  60.  
  61.    o  A 'Parent' gadget which allows you to jump back to the parent
  62.       of the current directory.
  63.  
  64.    o  A 'Ok' gadget which you use to end the selector and accept your
  65.       choices. This is equivalent to double clicking on a file name, or
  66.       to press return while the 'File' string
  67.  
  68.    o  A 'Cancel' gadget which you use to end the selector and reject
  69.       your choices.
  70.  
  71.     When the selector is first opened (and when you change directory),
  72.   the Device-List is searched for drives, volumes, and logical devices.
  73.   These are then added to the list. Then files and directories in the
  74.   current directory is added to the list, which remains sorted all the
  75.   time.
  76.     When you after or during the making of the list, scrool through
  77.   it, it will seem like it only contains files and directories. This is
  78.   not quite true; clicking the Menu button on the mouse will make the
  79.   drives, volumes and logical devices visible (C:, LIBS: etc.) at the
  80.   bottom of the list. After doing so, subsequent clicks with the Menu
  81.   button will move you quickly around in the list; when the name at the
  82.   top of the display is a a:
  83.      file,      a click will move you to the directories.
  84.      directory, a click will move you to the devices.
  85.      device,    a click will move you to the files.
  86.  
  87. Thats all.
  88.  
  89.