home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / BATCH / BATMNU13.ZIP / BATMNU13.DOC < prev    next >
Encoding:
Text File  |  1991-04-22  |  7.4 KB  |  173 lines
  1.  
  2.  
  3.                                   BATMNU.EXE
  4.                                  Warren Small
  5.                                    (c) 1991
  6.  
  7.      This  program is a menuing system for  use with your batch files.   It is
  8. not intended  to be a  'shell', although with  some very  ambitious batch file
  9. programming, it could be  used as one. Its purpose is to provide sophisticated
  10. flow control and  give batch  files a  professional appearance  by creating  a
  11. point-and-shoot menu with up to 26 options  per menu. The cursor keys  and the
  12. 'HOME' and  'END' keys can  then be used  to make the  selection. Each  option
  13. also can be selected by a 'hotkey' defined by your menu.
  14.  
  15.      Syntax: BATMNU [d:] [path] filename [label]
  16.  
  17.      The program defaults to  an extension of 'mnu'  if none is  provided. The
  18. filename  can be a separate file or, if you prefer, the menu can be within the
  19. calling batch file. You  will have to  code the batch file so those  lines are
  20. never executed,  of course. The  optional label parameter  can be  used if you
  21. wish  to put more than one menu  within the file. Bracket you  menu lines with
  22. ':label' and ':end_label'. BatMenu will search your path for the file if  it's
  23. not in the current directory. The label can be up to 15 characters.
  24.  
  25.      The format for the menu is as follows:
  26.  
  27.      :menu  {keyword to mark where the program should start reading}
  28.      window,tRED,hWHI,...   {colors and window appearance definition}
  29.      title,title text
  30.      option,option text,# {# indicates hotkey position in option text}
  31.      option,...
  32.      .
  33.      .
  34.      .
  35.      :end_menu  {Program stops reading and closes the file}
  36.  
  37.      The definition  can be organized  in almost  any order  as long as  it is
  38. placed between the ':menu' and ':end_menu' keywords (or  the label provided on
  39. the  command line). The  window line  should appear before the  options if you
  40. use the 'l' or  'a' parameter. Maximum title length  is 55 characters.  If you
  41. leave  the  title  out,  your menu  will  contain only  your  defined options.
  42. Maximum option length is 25 characters.
  43.  
  44.      Hotkey position  starts  at  1 and  will  default  to  that  position  if
  45. omitted. This is  also the default if you  miscount and enter  a number longer
  46. than the text.  Alternately, the hotkey can be  defined with a character.  The
  47. program will select the first  character that matches. You will  have to use a
  48. number if  you want  a later  occurring character  of the  same  type as  your
  49. hotkey. If  the program  cannot find any  options in the  file, a Menu  Format
  50. Error message  will be  displayed. If a  hotkey character  is duplicated,  the
  51. menu with return the  value associated with the  first option with that value.
  52. You can  let BatMenu  select the  hotkeys, if  you wish,  with the 'a'  window
  53. parameter. The choices can be overridden by the  option line selection and the
  54. menu  will default  to letter  choices if  it runs out  of characters  to pick
  55. from.
  56.  
  57.                                  Page 1 of 3
  58.                                    Ver. 1.3
  59.  
  60.                                   BATMNU.EXE
  61.                                  Warren Small
  62.                                    (c) 1991
  63.  
  64.      The 'window' line in  your menu will define the colors and appearance  of
  65. your menu. The color options are:
  66.  
  67.      f - foreground color of window
  68.      b - background color of window, only the first 8 colors are valid.
  69.      t - title color
  70.      o - option color
  71.      h - hotkey color
  72.      k - screen color (clears screen), the first 8 for this too.
  73.  
  74.      Window appearance options are:
  75.  
  76.      e - puts a solid color border around the screen's edge
  77.      s - shadow on
  78.      c - center each option individually
  79.      w - display menu in wide, 2 column format, default for > 12 options
  80.      l - default to letter selection of options
  81.      n - default to number selection of options, maximum of 10 options
  82.      a - automatic selection of hotkeys
  83.      m - menu frame type, 1 - ┌─, 2 - ╔═, 3 - ╒═, 4 - ╓─,  5 - █▀
  84.      ~ - Allows use of the Escape key to exit menu, returns errorlevel 0
  85.  
  86.      Color options should be followed by  one of the color values shown in the
  87. chart below.  Hotkeys can  be made  invisible by  using 'hinv'  on the  window
  88. line.  The hotkeys  will  still  select the  options  but the  menu  will  not
  89. indicate them. This  gives you the look of  a simpler 'light  bar' style menu.
  90. Additionally, the 'k' option  can include a fill  character after the color to
  91. give the screen background more  interest than a  flat color. Use of the  drop
  92. shadow is more dramatic too.
  93.  
  94.      The 'l' option can be useful  when you have a large  number of options or
  95. if  you just  prefer it  that way.  The 'n'  option  is  for those  who prefer
  96. numbered menus.  The 'c'  option is  overridden if  you use  'l' or 'n'.  With
  97. these  options, your  maximum option  length is 22  characters and  the hotkey
  98. will be set to 1.
  99.  
  100.      The 'e'  option must appear before  the 'k'. It  will use the  background
  101. color selected by 'k'.
  102.                                  COLOR VALUES
  103.  
  104.                0 or bla = Black      8 or BLA = Grey          
  105.                1 or blu = Blue       9 or BLU = Bright Blue   
  106.                2 or gre = Green     10 or GRE = Bright Green  
  107.                3 or cya = Cyan      11 or CYA = Bright Cyan   
  108.                4 or red = Red       12 or RED = Bright Red    
  109.                5 or mag = Magenta   13 or MAG = Bright Magenta
  110.                6 or yel = Brown     14 or YEL = Yellow        
  111.                7 or whi = White     15 or WHI = Bright White  
  112.  
  113.  
  114.                                  Page 2 of 3
  115.                                    Ver. 1.3
  116.  
  117.                                   BATMNU.EXE
  118.                                  Warren Small
  119.                                    (c) 1991
  120.  
  121.      Default colors  are  provided (fYEL,  bblu,  tWHI,  oCYA, hRED)  and  the
  122. options  will be  left-justified.  The menu  will be  in single  column format
  123. unless it exceeds 12 options. It will have a double line frame.
  124.  
  125.      DOS ERRORLEVEL is set on exit from BATMNU  with level 1 corresponding  to
  126. the first  option, etc. A level  0 is set whenever  the program encounters  an
  127. error (file not found  or parameter error) so you  should plan your batch file
  128. accordingly. If  the Escape  key option  is used,  this will  always return  a
  129. level  0.  Be  sure  to  order  your  errorlevel  statements  from largest  to
  130. smallest. See your DOS manual for more information.
  131.  
  132.      Executing  the program with  no parameter will display  a help screen and
  133. example menu.  A couple  of example files  are included in  this archive,  one
  134. showing a separate menu file and another a menu within a batch file.
  135.  
  136.      This program is provided as "shareware". Please try it out  for a week or
  137. two. If you like it and use it,  I would appreciate you sending $10  my way as
  138. a vote of confidence for a job well done. Paying  this fee also will encourage
  139. me to  make improvements  and/or correct  problems for  future versions.  Feel
  140. free to give it to  friends or upload it to other  BBS's provided that  no fee
  141. is charged for distribution and it is not modified in any way.
  142.  
  143.  
  144. Ver. 1.3 
  145. April 22, 1991
  146.  
  147. Warren Small
  148. 35 Benjamin Street
  149. Manchester, NH  03103
  150.  
  151. CIS  71076,407
  152. GENIE  W.SMALL
  153. Prodigy  RSJW31A
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.                                  Page 3 of 3
  172.                                    Ver. 1.3
  173.