home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / basic / library / pb / pbmnus / menuman.doc < prev    next >
Text File  |  1993-03-03  |  15KB  |  374 lines
  1.      
  2. ============================================================================
  3.  
  4.                         MENUMAN: EASY POWERBASIC MENUS
  5.  
  6.                         COPYRIGHT, 1992, 1993
  7.  
  8.                         SALT AND LIGHT SOFTWARE
  9.  
  10.                         1525 LOCUST ST.
  11.  
  12.                         READING, PA. 19604
  13.  
  14.  
  15. ============================================================================
  16.  
  17.  
  18.                               PROLOUGE
  19.  
  20.         MENUMAN 1.0  for Powerbasic is designed to generate menus with 
  21. selection by function keys, numbers and widebar selectors that travel 
  22. horzintally and vertically. The menus are loaded into a file called 
  23. "TESTMENU.BAS" and are loaded as subprograms. The reason for assigning 
  24. the menus as subprograms is that this gives the programmer more flexibility 
  25. to call the menu subprogram any time he wishes and to locate and assign 
  26. certain colors to the menus. Programs included on the disk:
  27.  
  28.  
  29.                         MENUMAN.EXE
  30.  
  31.                         MENUMAN.DOC
  32.  
  33.                         FKEYSAMP.BAS
  34.                         
  35.                         FKEYSAMP.EXE
  36.  
  37.                         HORZSAMP.BAS
  38.                         
  39.                         HORZSAMP.EXE
  40.  
  41.                         NUMBSAMP.BAS
  42.  
  43.                         NUMBSAMP.EXE
  44.  
  45.                         VERTSAMP.BAS
  46.  
  47.                         VERTSAMP.EXE
  48.  
  49.  
  50.  
  51.         The programmer may include the menus generated by MENUMAN 1.0 for 
  52. Powerbasic into his or her work on a royalty free basis.
  53.  
  54.  
  55. &&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&
  56.  
  57.         MENUMAN was born out of frustration. I was tired of coding menu files
  58. and forgetting "END SELECT" or rummaging around my source code files on disks
  59. and looking for the proper way to do the INSTR function or flipping through
  60. pages of books on programming on how to handle an error trap. So, I came
  61. with MENUMAN as a way to always put together a menu that would work and not
  62. have to spend hours of programming.
  63.  
  64.         MENUMAN will generate menus with selection by alternate keys, 
  65. function keys, a Lotus type menu, numbers selections and popup vertical bar 
  66. menus.  The following is a short tutorial on:
  67.  
  68.                 * The opening screen of MENUMAN
  69.  
  70.                 * An overview of the TOOLS section
  71.  
  72.                 * A step by step process of creating a menu
  73.  
  74.  
  75.  
  76.  
  77. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  78.  
  79.                         OPENING SCREEN
  80.  
  81. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  82.  
  83.         Type Menuman at your DOS prompt and the opening screen of MENUMAN
  84. will be staring back at you in a few seconds. To select a menu function, use 
  85. up or down arrows to move the widebar selector and then press ENTER when you
  86. are at the menu type you want. If you want to use one of MENUMAN's tools (you
  87. don't have to return them, neighbor) move the widebar selector to TOOLS and
  88. press ENTER. To exit MENUMAN, move the widebar selector over to EXIT and
  89. press ENTER. (Hint: the home and end keys will send you to EXIT).
  90.  
  91.  
  92. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  93.  
  94.                         TOOLS SECTION
  95.  
  96. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  97.  
  98.         After you enter the TOOLS section of MENUMAN, you will see a box
  99. with the following options:
  100.  
  101.                         COLOR SELECTOR
  102.  
  103.                         CHANGE DIRECTORY
  104.  
  105.                         BOX LOCATOR
  106.  
  107.                         BOX STYLES
  108.  
  109.                         EXIT
  110.  
  111.         Move the widebar cursor over each item and Press ENTER at the one
  112. you want.
  113.  
  114.         Here is an overview of each section of TOOLS
  115.  
  116.         #################################################
  117.  
  118.                         COLOR SELECTOR
  119.  
  120.  
  121.  
  122.         After the widebar cursor is placed over the first entry and ENTER is
  123. pressed, the user will see how a menu will look with different colors. 
  124. You will see a box popup in the lower right handed corner of the screen with
  125. a range of colors, number 1 through 15. Type in the foreground color of your
  126. choice and then type in the background color of your choice. Then a smaller
  127. box will appear, showing you how you color selections will look on the screen.
  128. If you want to choose another color combination press the Number 1, or if
  129. you want to exit to MENUMAN's opening screen, press Number 2.
  130.  
  131.  
  132.        ########################################################
  133.  
  134.  
  135.                           CHANGE DIRECTORY
  136.  
  137.         The second option will change the directory inside any drive by typing in 
  138. the drive letter and the name of the directory or subdirectory you wish.
  139.  
  140.                         Example: C:\QB\MENUS\SHIP
  141.  
  142.  
  143.         ######################################################
  144.  
  145.  
  146.                           BOX LOCATOR
  147.  
  148.  
  149.         The third choice on the TOOLS menu will show what your menu will look 
  150. like at designated screen locations. A distored display means that your menu 
  151. went below the 25-row limit, or beyond the 80-column limit.
  152.  
  153.  
  154.         #######################################################
  155.  
  156.                           BOX STYLES
  157.  
  158.  
  159.         The fourth choice on TOOLS menu will show five styles of boxes
  160. offered in your menu subprogram.
  161.  
  162.  
  163.  
  164.  
  165.         ________________________________________________________
  166.  
  167.  
  168.                         MENU CREATION
  169.  
  170.         ________________________________________________________
  171.  
  172.         Step by step instructions on how to create menus:
  173.  
  174.                          ALTERNATE KEYS MENUS
  175.  
  176.         First step: Leave the widebar selector on MENUS and then press 
  177. ENTER. The menu of menu choices will appear and the widebar selector will 
  178. be placed on the function keys menu item; press ENTER.
  179.  
  180.         Second step: An input box will appear on the lower portion 
  181. of the screen. Type in the desired number of entries (2 to 7) then press 
  182. Enter.
  183.  
  184.         (Hint: items are limited to 10 cols in length. Menuman will
  185. let you know if you have gone over the limit by sounding a chime. The entry
  186. will be erased and you will be asked to retype it. Any entry can be edited in
  187. place by pressing the ESC key. The edit function will only work with the 
  188. current entry). 
  189.         Then the next entry will appear. Continue to press ENTER until all 
  190. the selections for your menu have been entered. There is no need to provide 
  191. an entry for an "EXIT" or  "QUIT" option because MENUMAN automatically 
  192. designates the last item in the menu for this purpose.
  193.         
  194.         (Hints: Menuman will select the first letter of your entry as the hot
  195. key. Your letter selection will be marked in the letters and numbers box. What
  196. if you have entries that start with the same letter? Well, there are two ways
  197. to work around that situation.
  198.         1. Use the numbers as a means of utilizing entries with the same
  199. letters. Do it this way by typing: 1MENUMAN, or 2BOXMAKER. That's right no
  200. spaces between numbers and words.
  201.  
  202.         2. Misspell the entry like this "EMNUMAN. The letter "E" will have
  203. a box around it in the finished menu. You will have to shift the lower case
  204. "m" to the first position in the word and make several other small 
  205. adjustments to get the memu the way you want it.)
  206.  
  207.  
  208.  
  209.         Fourth step: Another box will appear asking you if you want to save
  210. the menu to "TESTMENU.BAS" or quit the process and return to the Main Menu.
  211. If you select to save the menu, it will be placed in the current path which
  212. you are working. (Directories and paths may be changed by using the Change 
  213. Directory option in the Tools Menu.)
  214.  
  215.         (Hint: a working model of an alternate keys menu with has
  216.         been included on the disk. A compiled version has also been included)
  217.  
  218.         
  219.                          FUNCTION KEYS MENUS
  220.  
  221.         First step: Leave the widebar selector on MENUS and then press 
  222. ENTER. The menu of menu choices will appear and the widebar selector will 
  223. be placed on the function keys menu item; press ENTER.
  224.  
  225.         Second step: An input box will appear on the lower portion 
  226. of the screen. Type in the desired number of entries (2 to 9) and press Enter.
  227.  
  228.         (Hint: items are limited to 15 cols in length. Menuman will
  229. let you know if you have gone over the limit by sounding a chime. The entry
  230. will be erased and you will be asked to retype it. Any entry can be edited in
  231. place by pressing the ESC key. The edit function will only work with the 
  232. current entry). 
  233.  
  234.         Then the next entry will appear. Continue to press ENTER until all 
  235. the selections for your menu have been entered. There is no need to provide 
  236. an entry for an "EXIT" or  "QUIT" option because MENUMAN automatically 
  237. designates the last item in the menu for this purpose.
  238.  
  239.         Fourth step: Another box will appear asking you if you want to save
  240. the menu to "TESTMENU.BAS" or quit the process and return to the Main Menu.
  241. If you select to save the menu, it will be placed in the current path which
  242. you are working. (Directories and paths may be changed by using the Change 
  243. Directory option in the Tools Menu.)
  244.  
  245.  
  246.         (Hint: a working model of a Funtion keys menu with has
  247.         been included on the disk. A compiled version has also been included)
  248.  
  249. _________________________________________________________________________
  250.  
  251.  
  252.                          LOTUS TYPE MENUS
  253.  
  254.         First step: Leave the widebar selector on MENUS and then press 
  255. ENTER. The menu of menu choices will appear; move the  widebar selector to 
  256. the Horizontal menu item and press ENTER.
  257.  
  258.         Second step: An input box will appear on the lower portion 
  259. of the screen. Type in the desired number of entries (2 to 7) and press Enter.
  260.  
  261.  
  262.         (Hint: items are limited to 10 cols in length. Menuman will
  263. let you know if you have gone over the limit by sounding a chime. The entry
  264. will be erased and you will be asked to retype it. Any entry can be edited in
  265. place by pressing the ESC key. The edit function will only work with the 
  266. current entry). 
  267.         
  268.         Then the next entry will appear. Continue to press ENTER until all 
  269. the selections for your menu have been entered. There is no need to provide 
  270. an entry for an "EXIT" or  "QUIT" option because MENUMAN automatically 
  271. designates the last item in the menu for this purpose.
  272.  
  273.         Third step: Another box will appear asking you if you want to save
  274. the menu to "TESTMENU.BAS" or quit the process and return to the Main Menu.
  275. If you select to save the menu, it will be placed in the current path which
  276. you are working. (Directories and paths may be changed by using the Change 
  277. Directory option in the Tools Menu.)
  278.  
  279.         (Hint: a working model of a Horizontal menu with notations has
  280.         been included on the disk. A compiled version also has been included.)
  281.  
  282. ____________________________________________________________________________
  283.  
  284.                        NUMBERS SELECTION MENUS
  285.  
  286.         First step: Leave the widebar selector on MENUS and then press 
  287. ENTER. The menu of menu choices will appear; move the  widebar selector to 
  288. the Numbers menu item and press ENTER.
  289.  
  290.         Second step: An input box will appear on the lower portion 
  291. of the screen. Type in the desired number of entries (2 to 9) and press Enter
  292.  
  293.         (Hint: items are limited to 15 cols in length. Menuman will
  294. let you know if you have gone over the limit by sounding a chime. The entry
  295. will be erased and you will be asked to retype it. Any entry can be edited in
  296. place by pressing the ESC key. The edit function will only work with the 
  297. current entry). 
  298.  
  299.         Then the next entry will appear. Continue to press ENTER until all 
  300. the selections for your menu have been entered. There is no need to provide 
  301. an entry for an "EXIT" or  "QUIT" option because MENUMAN automatically 
  302. designates the last item in the menu for this purpose.
  303.  
  304.         Third step: Another box will appear asking you if you want to save
  305. the menu to "TESTMENU.BAS" or quit the process and return to the Main Menu.
  306. If you select to save the menu, it will be placed in the current path which
  307. you are working. (Directories and paths may be changed by using the Change 
  308. Directory option in the Tools Menu.)
  309.  
  310.  
  311.         (Hint: a working model of a Numbers menu with has
  312.         been included on the disk. A compiled version also has been included.)
  313.  
  314. ____________________________________________________________________________
  315.  
  316.                        VERTICAL SELECTION MENUS
  317.  
  318.         First step: Leave the widebar selector on MENUS and then press 
  319. ENTER. The menu of menu choices will appear; move the  widebar selector to 
  320. the Vertical menu item and press ENTER.
  321.  
  322.         Second step: An input box will appear on the lower portion 
  323. of the screen. Type in the desired number of entries (2 to 9) and press Enter
  324.         
  325.         (Hint: items are limited to 15 cols in length. Menuman will
  326. let you know if you have gone over the limit by sounding a chime. The entry
  327. will be erased and you will be asked to retype it. Any entry can be edited in
  328. place by pressing the ESC key. The edit function will only work with the 
  329. current entry). 
  330.         Then the next entry will appear. Continue to press ENTER until all 
  331. the selections for your menu have been entered. There is no need to provide 
  332. an entry for an "EXIT" or  "QUIT" option because MENUMAN automatically 
  333. designates the last item in the menu for this purpose.
  334.  
  335.         Third step: Another box will appear asking you if you want to save
  336. the menu to "TESTMENU.BAS" or quit the process and return to the Main Menu.
  337. If you select to save the menu, it will be placed in the current path which
  338. you are working. (Directories and paths may be changed by using the Change 
  339. Directory option in the Tools Menu.)
  340.  
  341.         (Hint: a working model of a Vertical menu with has
  342.         been included on the disk. A compiled version also has been included.)
  343.  
  344. **************************************************************************
  345.  
  346.         I am asking a registration fee of $5 for this programming effort. 
  347. As any programmer knows, a great deal of time goes into any program. 
  348. The gestation period usually isn't nine months but the labor pains can be 
  349. memorable. Registered users can purchase MENUMAN updates at costs of under $7.
  350.  
  351.         Send all comments and/or orders to me by one of these methods:
  352.  
  353.         Through a letter or postcard to:
  354.                         
  355.                         CARMEN PAONE
  356.                         SALT AND LIGHT SOFTWARE
  357.                         1525 LOCUST ST.
  358.                         READING, PA. 19604
  359.         
  360.         On Compuserve as CARMEN PAONE [72677, 42]
  361.         
  362.         On Genie as C. PAONE
  363.         
  364.         On Delphi as CARMENPAONE
  365.         
  366.         On America On-Line as CARMENP805
  367.  
  368. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  369.         
  370.         One final word, no matter what decision you make on MENUMAN, do
  371. yourself a soul-saving service and read John 3:16 in any Bible.
  372.  
  373. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  374.