home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / LS321.ZIP / SELEFILE.DOC < prev    next >
Text File  |  1988-09-18  |  6KB  |  128 lines
  1. SELEFILE is a small DOS program that allows you to select a file from a
  2. list of files displayed on the screen.  It can be run stand-alone, although
  3. there is no good reason to do so or from within another program.  SELEFILE
  4. pops up over the existing screen and restores the screen on exit.
  5.  
  6. The syntax for SELEFILE is:
  7.  
  8. SELEFILE pathname [urc ulc rows cols normal reverse highlight [title]]
  9.  
  10. where:
  11.      pathname    is the set of files to display.  * and ? are allowed.
  12.                  (E.G. \dos\*.com -- will display all .COM files in the \DOS
  13.                   directory)
  14.      urc ulc     is the top left hand corner of the file display box.
  15.                  These are specified relative to 0.  The default is 12,12
  16.      rows        is the size of the window in rows, default is 12.
  17.      cols        is the number of columns of file names to display, the default
  18.                  is 4.
  19.      normal      is a decimal number from 0 to 255 for the colors of a normal
  20.                  (non high lighted display), the default is: 3 (CYAN on Black)
  21.      reverse     is a decimal number from 0 to 255 for the colors of a reverse
  22.                  video display.  The default is: 48 (Black on CYAN).
  23.      highlight   is a decimal number from 0 to 255 for the colors of a high
  24.                  lighted display.  The default is 17, but it is not used,
  25.                  although it must be present if a title is specified.
  26.      title       is the title that is to be displayed on the file selection
  27.                  window.  It may also be placed in the environment using
  28.                  SET TITLE=....
  29.  
  30. When the SELEFILE window is displayed, you can perform the following functions:
  31.  
  32. You can use the file selector to select a file from the list displayed
  33. or change the list of files to be displayed or enter your own file name.
  34.  
  35. Position to a file using the arrow keys, PgUp, PgDn, HOME, END or by
  36. typing the first letter of a file name.  HOME will display the list
  37. starting at the first file.  END will display the list ending with the
  38. last file.  Pressing the first letter of a file name will position the
  39. cursor to the first file in the list which starts with that letter.
  40. Press the RETURN key to select the high lighted file.
  41.  
  42. Other KEYS:
  43.  
  44. ESC will cancel without selecting a file
  45.  
  46. TAB allows you to enter a file name or change the files being displayed.
  47.     When you press TAB, you can enter a file name or path name.  If a
  48.     file name is entered, the File Selector will return that file name.
  49.     If a directory is entered or wild card characters (*,?) are entered
  50.     the File Selector will display the selected path.
  51.  
  52. F2  allows you to move the File Selector to a different position.
  53.  
  54.  
  55. Example:
  56.  
  57. Use the SET TITLE option to set a title and display all the files in
  58. D:\LSORT
  59.  
  60.  
  61. Issue the following commands:
  62.  
  63. C:>set title=Files in Directory LSORT
  64. C:>SELEFILE D:\LSORT\*.*
  65.  
  66. The following display will pop up:
  67.  
  68.  
  69.  ┌──────────────────Directory of D:\LSORT\*.*─────────────────────┐
  70.  │Position to a file or directory(*), RETURN to Select, ESC to    │
  71.  │CANCEL, or TAB to enter NEW Directory or Filename here:         │
  72.  │                                                                │
  73.  │Dir: D:\LSORT\*.*                                               │
  74.  │                                                                │
  75.  │*..              ADDRESS.PRG     ADJUST.PRN      BUILDSRC.BAT   │
  76.  │ CROSSASC.DOC    DEETER.DOC      FILE3.LST       FILELIST.DOC   │
  77.  │ FILES.LST       JOERECPT        LBLLIST         LOVELOCK.DOC   │
  78.  │ LSORT.DOC       LSORT.LBL       LSORT.LVR       LSORT.TXT      │
  79.  │ LSORT23.ARC     LSORT23.DOC     LSORT23S.ARC    LSORT301.LVR   │
  80.  │ LSORTDAT.ARC    LSORTDC.MAK     LSORTLNK.BAT    LSORTMC.LNK    │
  81.  F1=HELP─────────────────────────────────────────────────────PgDn─┘
  82.  
  83. A reverse video cursor will also display. The PgDn in the lower right hand
  84. corner of the window indicates that there are more files, and that you can
  85. see them by pressing PgDn.  If PgDn were pressed the display would change
  86. as shown below:
  87.  
  88.  
  89.  ┌──────────────────Directory of D:\LSORT\*.*────────────────PgUp─┐
  90.  │Position to a file or directory(*), RETURN to Select, ESC to    │
  91.  │CANCEL, or TAB to enter NEW Directory or Filename here:         │
  92.  │                                                                │
  93.  │Dir: D:\LSORT\*.*                                               │
  94.  │                                                                │
  95.  │ LSORTMC.MAK     LSORTMSC.MAK    LSORTTC.LNK     LSORTTC.MAK    │
  96.  │ LSRT.ARC        LSRT.DOC        LSRT301S.ARC    LSRT3E.ARC     │
  97.  │ LSRT3O.ARC      LSRTLIBD.ARC    LSRTLIBM.ARC    LSRTNOTE.DOC   │
  98.  │ MAKEMSC.BAT     MCH.ARC         MDM370.DEF      NEWPATH.BAT    │
  99.  │ PCCLONE.DOC     README.DOC      REGUSER.DBF     SACHS.DOC      │
  100.  │ SELEFILE.$$$    SELEFILE.DOC    STATEFRM.DOC    TEDHARE.DOC    │
  101.  F1=HELP─────────────────────────────────────────────────────PgDn─┘
  102.  
  103. PgDn is still displayed indicating that there are yet more files to see.  PgUp
  104. is also displayed in the upper right hand corner, indicating that pressing the
  105. PgUp key will also display more files.  Let's select file SELEFILE.DOC by
  106. moving the cursor to it and pressing return.  The display will change as below:
  107.  
  108.  
  109.  ┌──────────────────Directory of D:\LSORT\*.*────────────────PgUp─┐
  110.  │Selection:                                                      │
  111.  │D:\LSORT\SELEFILE.DOC                                           │
  112.  │ Press RETURN to confirm, any other character to CANCEL         │
  113.  │Dir: D:\LSORT\*.*                                               │
  114.  │                                                                │
  115.  │ LSORTMC.MAK     LSORTMSC.MAK    LSORTTC.LNK     LSORTTC.MAK    │
  116.  │ LSRT.ARC        LSRT.DOC        LSRT301S.ARC    LSRT3E.ARC     │
  117.  │ LSRT3O.ARC      LSRTLIBD.ARC    LSRTLIBM.ARC    LSRTNOTE.DOC   │
  118.  │ MAKEMSC.BAT     MCH.ARC         MDM370.DEF      NEWPATH.BAT    │
  119.  │ PCCLONE.DOC     README.DOC      REGUSER.DBF     SACHS.DOC      │
  120.  │ SELEFILE.$$$    SELEFILE.DOC    STATEFRM.DOC    TEDHARE.DOC    │
  121.  F1=HELP─────────────────────────────────────────────────────PgDn─┘
  122.  
  123. If you are happy with your selection, you can press RETURN again.  If you do,
  124. the pop up window above will go away and SELEFILE.$$$ will contain:
  125.  
  126. D:\LSORT\SELEFILE.DOC
  127.  
  128.