Liren Large Software Subsidy 16

home *** CD-ROM | disk | FTP | other *** search

/ Liren Large Software Subsidy 16 / 16.iso / t / t195 / 1.img / BATMNU23.DOC < prev next >

Wrap

Text File | 1993-11-08 | 35.4 KB | 867 lines

┌────────────────────────────────────┐ │ ╔══════════════════════════════╗ │▒▒ │ ║ ║ │▒▒ │ ║ BATMNU ║ │▒▒ │ ║ Batch File Menu System ║ │▒▒ │ ║ Version 2.3 ║ │▒▒ │ ║ ║ │▒▒ │ ╚══════════════════════════════╝ │▒▒ └────────────────────────────────────┘▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ November 8, 1993 TABLE OF CONTENTS 1.0 INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.1 Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2.0 MENU FORMAT . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2.1 General Format Rules . . . . . . . . . . . . . . . . . . . 1 2.2 Window Options . . . . . . . . . . . . . . . . . . . . . . 2 2.3 Window Appearance . . . . . . . . . . . . . . . . . . . . . 3 2.4 Other Window Options . . . . . . . . . . . . . . . . . . . 4 2.5 Option Lines . . . . . . . . . . . . . . . . . . . . . . . 5 2.6 Option Help . . . . . . . . . . . . . . . . . . . . . . . . 5 2.7 Headers and Footers . . . . . . . . . . . . . . . . . . . . 5 3.0 WHAT HAPPENS IN THE BATCH FILE? . . . . . . . . . . . . . . . . 6 4.0 MENUS WITH PARAMETERS . . . . . . . . . . . . . . . . . . . . . 7 5.0 MOUSE SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . 8 6.0 SCREEN SAVER . . . . . . . . . . . . . . . . . . . . . . . . . . 8 7.0 SHAREWARE INFORMATION . . . . . . . . . . . . . . . . . . . . . 9 7.1 New Security Version . . . . . . . . . . . . . . . . . . . 9 7.2 New Utility Available . . . . . . . . . . . . . . . . . . . 9 7.3 Bonus Program . . . . . . . . . . . . . . . . . . . . . . . 10 7.4 Bonus CD from JCS Marketing . . . . . . . . . . . . . . . . 10 8.0 BATMNU History . . . . . . . . . . . . . . . . . . . . . . . . . 11 APPENDIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 BATMNU v2.3 Warren Small (c) 1993 1.0 INTRODUCTION ───────────────────────────────────────────────────────────────────────── This program is a menuing system for use with your batch files. It is not intended to be a shell, although with some very ambitious batch file programming, it could be used as one. Even nested menus are possible. Its purpose is to provide sophisticated flow control and give batch files a professional appearance by creating a point-and-shoot menu with up to 26 options per menu. The cursor keys and the HOME and END keys can then be used to make the selection. Each option can be selected by a 'hotkey' defined by your menu. A mouse is also supported if detected and there is a Screen Saver feature to protect your display. 1.1 Syntax ───────────────────────────────────────────────────────────────────────── BATMNU [d:][path]filename [label] [default] The program defaults to a filename extension of "mnu" if none is provided. The filename can indicate a separate file or, if you prefer, the menu can be within the calling batch file. You will have to code the batch file so those lines are never executed, of course. If a separate file is used, it can be 'hidden' making it more secure from tapering. The optional label parameter can be used if you wish to put more than one menu within the file. Bracket your menu lines with ":label" and ":end_label". BATMNU will search your path for the file if it's not in the current directory. The label can be up to 15 characters long. The default parameter on the command line is used if you want an option other than the first one to be highlighted when the menu starts. e.g. "BATMNU NORTON.BAT 3" will highlight the third option. 2.0 MENU FORMAT ───────────────────────────────────────────────────────────────────────── :menu {keyword to mark where the program should start reading} header,header text h_format,fYEL,bred,t1,d1 {header colors, time, date} window,tRED,hWHI,... {colors and window appearance definition} title,title text option,option text,[#] {# indicates hotkey position in option text} help,help text {must follow option help refers to} option,option text,[#][,[drive],[directory],pgm] {optional format} option... . . . footer,footer text f_format,fYEL,bred,t1,d1 {footer colors, time, date} :end_menu {Program stops reading and closes the file} 2.1 General Format Rules ───────────────────────────────────────────────────────────────────────── The definition can be organized in almost any order as long as it is placed between the ':menu' and ':end_menu' keywords (or other label if Page 1 BATMNU v2.3 Warren Small (c) 1993 provided on the command line). The window line should appear before the options if you use the 'l', 'n' or 'a' parameter. Maximum title length is 54 characters. Headers and footers can be 70 characters long if the time and/or date are not used. If you leave the title out, your menu will contain only your defined options. Header and footer are optional. Maximum option length is 50 characters for single column menus and 25 characters for double column.(See "no_margin" description on page 4 for longer title and option lines.) Maximum help length is 70 characters. All parameters on the window, h_format and f_format lines are separated by a comma. Spaces are ignored. The keywords can be indented for clarity, if desired, using spaces or TABs. Environment variables can be used within the header, footer, options, help lines or title. The variables are indicated by surrounding the name with the percent (%) sign, just as you would on a batch file command line. The variable's value is inserted when the menu is displayed. If the variable is not found, the variable name is used as it appears in the menu with % signs. 2.2 Window Options ───────────────────────────────────────────────────────────────────────── The "window" line in your menu will define the colors, appearance and actions of your menu. Each switch of keyword should be separated by a comma. The color options are: f# - foreground color of window (0-15) b# - background color of window, (0-7) t# - title color (0-15) o# - option color (0-15) h# - hotkey color (0-15) k# - screen color (clears screen), foreground(0-15), background(0-7) e# - screen border color (0-15) Color options should be followed by one of the color values shown in the chart below. Hotkeys can be made invisible by using "hinv" on the window line. The hotkeys will still select the options but the menu will not indicate them. This gives you the look of a simpler "light bar" style menu. COLOR VALUES 0 or bla = Black 8 or BLA = Grey 1 or blu = Blue 9 or BLU = Bright Blue 2 or gre = Green 10 or GRE = Bright Green 3 or cya = Cyan 11 or CYA = Bright Cyan 4 or red = Red 12 or RED = Bright Red 5 or mag = Magenta 13 or MAG = Bright Magenta 6 or yel = Brown 14 or YEL = Yellow 7 or whi = White 15 or WHI = Bright White The 'k' option fills double duty setting the foreground and background color for the screen. The first k parameter will set the background, the second the foreground (Foreground default is "whi" if not specified). Page 2 BATMNU v2.3 Warren Small (c) 1993 The foreground color is used with the fill character. The fill character can appear after the color of either to give the screen background more interest than a flat color. Use of the drop shadow is more dramatic too. If you prefer, a string could be used to fill the screen background. Either words or special characters could be used. Put the string after the color as above. If you want to add spaces, use the underscore (_) character. It will be treated as a space when displayed. (e.g. kred_Main_Menu) The 'e' option sets the screen border color which is outside the normal text area. An 'e' used alone will reset the border to its normal black. Default colors are provided (fYEL, bblu, tWHI, oCYA, hRED) and the options will be left-justified. The menu will be in single column format unless it exceeds 12 options. It will have a double line frame (m2). Default colors for headers/footers are fWHI, bred. 2.3 Window Appearance ───────────────────────────────────────────────────────────────────────── The window appearance options are: s# - shadow on, 1-4 to position shadow relative to menu c - center each option individually w - display menu in wide, 2 column format, default for > 13 options l - default to letter selection of options n - default to number selection of options, maximum of 10 options a[n] - automatic selection of hotkeys. [optional no case favoring] m# - menu frame type, 1 - ┌─, 2 - ╔═, 3 - ╒═, 4 - ╓─, 5 - █▀ r# - top row for menu window c# - left column for menu window no_margin - display menu without wide margin around the frame popup - save entire screen and restore when menu closes The shadow position is set with the 's' option. 1 is below and to the right. 2 is below and the to left. 3 is above and to the right. 4 is above and to the left. The 's' option alone defaults to 1. Menu options are normally left justified. If you want your options centered in the menu, use the 'c' switch. If you want a 2 column menu, the 'w' switch will force BATMNU into this mode. As a default, menus with more than 13 options are always displayed this way. The 'l' option can be useful when you have a large number of options or if you just prefer it that way. The 'n' option is for those who prefer numbered menus. Naturally, only 10 options are possible with numbers as hotkeys. The 'c' option is overridden if you use 'l' or 'n'. With these options, your maximum option length is reduced by 3 characters and the hotkey position will be set to 1. If you follow the 'l' or 'n' with another character such as a dash, period or parenthesis, this will be Page 3 BATMNU v2.3 Warren Small (c) 1993 used as a separator. (e.g. 'l-' will produce 'A-', 'B-', etc for the menu.) It is not necessary to specify the hotkeys for your options. If you leave this information out, BATMNU defaults to the first character. By using the 'a' switch, BATMNU will make sure you don't end up with duplicates. It makes a one-pass search to find unique letters for all the options. You can override the selection by indicating the hotkey on the option line. The search favors uppercase letters unless the no-case modifier is used, 'an'. To place the menu at a position other than centered on the screen, the 'r' and 'c' switches will define the position of the upper left hand corner. BATMNU will make adjustments to ensure the menu and shadow, if used, will remain within the screen boundaries. BATMNU will not confuse 'c' (centered) with 'c#', column #. If you prefer that the menu does not have the large margin around the menu, use the "no_margin" keyword to eliminate it. This will increase the Title and Option line maximum length to 60 and 56 respectively. It the menu is in 2 column format, the max option length is 28. You have the option to save the entire screen before BATMNU displays the menu, and restore the saved contents after the menu closes. Include the keyword "popup" on the "window" line to make this happen. Cursor position is saved as well. 2.4 Other Window Options ───────────────────────────────────────────────────────────────────────── There are four other options for the window line: x - disables the mouse. No search is performed. p - Screen Saver Pause v - Option Return Value ~ - Allows use of the Escape key to exit menu, returns errorlevel 0 Use 'x' if you do not want to use the mouse. The mouse check is skipped when the program starts and there is no delay in activating the menu. This option has no effect on systems without a mouse. 'p' controls the pause time before the Screen Saver activates. The default is 5 minutes. The Screen Saver can be disabled with 'p0' and the maximum setting is 30 minutes (p30). Information about the option chosen can be returned through the environment by using the 'v' option. It extracts a portion or all of the option's text and can be used for a number of things. Its format is "v#var" where # controls the number of characters to return (1-60) and var is the variable name to use. If the variable name is not specified, BATMNU will use "VAL". In retrieving the text, if # is larger than the option's length, the entire option text is returned. If you use the letter or number option, the label is skipped so that just the option's text is placed in the environment. See the example batch file, Page 4 BATMNU v2.3 Warren Small (c) 1993 NORTONV.BAT, to see how this feature can be used to eliminate "if errorlevel" statements and simplify the batch file. NOTE: DOS 3.3 or higher is needed to use this feature. Normally, ESCape is not a valid key for a menu. If you wish ESCape to be active, place a '~' on the window line. Errorlevel 0 will be returned. If the 'v' option is used, the environment variable will be set to "ESC". 2.5 Option Lines ───────────────────────────────────────────────────────────────────────── As stated above, the format for the option line is: option,Option Text,hotkey[,drive letter,directory,program params] Hotkey position starts at 1 and will default to that position if omitted or the number is longer than the text. Alternately, the hotkey can be defined with a character. BATMNU will first search the option text for an uppercase letter that matches. If there is no uppercase match, the program will do a lowercase search for the first character that matches. (e.g. "Disk Info,i" will highlight the I of "Info". "Disk Filer,i" will highlight the i in "Disk".) Use a number if you want a specific character as your hotkey. If a hotkey character is duplicated, the menu will return the value associated with the first option with that hotkey if the hotkey is pressed. If the highlight bar is used to select an option with a duplicate hotkey value, the highlighted option value will be returned. You can let BATMNU select the hotkeys, if you wish, with the 'a' window parameter. The choices can be overridden by the option line selection. The menu will default to letter choices if it runs out of characters to pick from. This procedure will also favor uppercase characters before lowercase. To override this, use 'an' (auto hotkey, no case). If the program cannot find any options in the file, a Menu Format Error message will be displayed. Refer to the section, Menus With Parameters (page 7), to see a description of the drive, directory and program options. 2.6 Option Help ───────────────────────────────────────────────────────────────────────── The Help line specifies text which will appear in the footer (See below.) when the option is highlighted. It can be up to 70 characters long and can appear with the time and date. This will restrict the help line length some, depending on the time/date format used. The help must follow the option it refers to creating option/help pairs in the menu. e.g. "option,Norton Commander" could be followed by "help,File Utility". 2.7 Headers and Footers ───────────────────────────────────────────────────────────────────────── Header and Format format lines have the following options: Page 5 BATMNU v2.3 Warren Small (c) 1993 f# - Text Foreground color (0-15) b# - Text Background color (0-7) t# - Display time of day (0-4) d# - display today's date (0-5) popup - show text while menu is displayed only The header and footer items define a line of text to appear at the top and bottom of the screen. The entire row will be colored with the background color. Colors are defined on the h_format and f_format lines using the f# (foreground) and b# (background) parameters as shown above. Refer to Window Options on page 2 for more information on colors. Another option for the f_format and h_format lines is the keyword "popup". Normally, the header and footer lines remain after the menu selection is made. If you want either or both of these lines to disappear with the menu, include the keyword "popup" on the appropriate format line. Their appearance will be the same when the menu is displayed, however, they will disappear, restoring the original lines, or the menu background if k# was used (p. 2), when the menu closes. The time and date can appear in the header and / or footer. On the format line(s) include a 't' for time and 'd' for date followed by a number indicating the format to use. They are as follows: TIME DATE 0 - HH:MM:SS (default) 0 - MM/DD/YY (default) 1 - HH:MM:SS am 1 - MM/DD/YYYY 2 - HH:MM am 2 - DDD MMM DD, YYYY 3 - HH.MM.SS 3 - DD/MM/YY 4 - HH.MM 4 - DD/MM/YYYY 5 - DDD DD MMM YYYY The date will appear to the left of the header or footer and the time will appear to the right. If the header/footer is too long, the time and date information could overwrite it. A footer can be combined with help (See above.) with the help text given precedence. If an option has no help line, the footer text is displayed. 3.0 WHAT HAPPENS IN THE BATCH FILE? ───────────────────────────────────────────────────────────────────────── If you execute the sample batch file, NORTON.BAT, you will see a menu displaying several choices. If you choose one of the options, you will probably see a lot of DOS error messages as the chance of your computer being set up the same way is negligible. When you view the batch file, you can get a good idea how BATMNU operates. The menu is near the beginning of the batch file mainly for speed. You will notice a "GOTO START" statement which causes the batch to branch around the menu. After the ":START" label is the command line that calls BATMNU and tells it what file the menu is in. If this file is not in your PATH or in the current directory when started, you would need to specify the full path name. .e.g BATMNU D:\UTIL\NORTON.BAT Page 6 BATMNU v2.3 Warren Small (c) 1993 DOS ERRORLEVEL is set on exit from BATMNU with EL 1 corresponding to the first option, etc. A series of "if errorlevel x goto ..." statements after the line calling BATMNU will allow the batch file to determine which option was selected and branch to the appropriate label. EL 127 is set whenever the program encounters an error (file not found or parameter error) so you should plan your batch file accordingly. If the Escape key option is used, this will always return an EL 0. Be sure to order your errorlevel statements from largest to smallest since "if errorlevel 3" will be true for EL=3 or greater. See your DOS manual for more information. Executing BATMNU with no parameter will display a help screen and example menu if the file BATMNU.HLP, included in the original archive file, can be found (See the Appendix for more info on this file). If you type the command "BATMNU NORTON.BAT" from the DOS prompt, the menu will be displayed as before but nothing will happen when you make a choice. You need to run the batch file itself to get anything to start. Several example files are contained in this archive, including one showing a separate menu file, another a menu within a batch file, and a third detailing a menu with parameter passing. 4.0 MENUS WITH PARAMETERS ───────────────────────────────────────────────────────────────────────── Optionally, a program can be started directly from BATMNU. This will result in shorter batch files as minimal ERRORLEVEL checking is necessary. You will also find the programs will start faster since there is no batch file processing. The option line contains additional information relating to the drive, directory and program name is this form: option,Word Perfect,w,c:,\wp51,wp In this example, BATMNU will change the drive and directory and start WP when this option is selected. When WP is finished, you are returned directly to your batch file. BATMNU sets an environment variable, ERRLEV, to identify the program run. You may wish to do further processing based on the program run or you can check for an ERRORLEVEL code returned from that program. The ERRLEV variable will equal the number of the option picked. If WP was the third option, ERRLEV=3 would be in the environment. You could then run an automatic backup procedure for WP with the line "if %ERRLEV%!==3! goto wpbackup". Additional parameters can be passed to your program. Simply include them after the program name as you normally would. option,Paradox - Phones,11,e:,\paradox\phones,paradox3 phone.scr This line would start Paradox which would then run the script phone.scr. It is recommended that your batch file clear the ERRLEV variable at the beginning and end to preserve space and prevent your batch file from acting on old information in the environment. The statement "SET ERRLEV=" will do this. Page 7 BATMNU v2.3 Warren Small (c) 1993 If there are no parameters on a line, you can use BATMNU the same way as earlier versions and the ERRLEV variable will not be set. If you want to leave out the drive and/or directory parameters, leave a comma to mark it. BATMNU will assume the program can be found in your PATH. If you don't use any parameters for an option, the placeholders are not necessary. See the files NORTONP.BAT and NORTON.BAT in this archive for a comparison. If you want the highlight bar to be on the option you just selected after returning, the ERRLEV variable can be used on the command line to set the default option. The command: BATMNU NORTONP.BAT %ERRLEV% will do this. Refer to the example file NORTONP.BAT to see how this is set up. IMPORTANT NOTE: DOS 3.3 or higher is required if you want to use parameters on the option lines. This is necessary so that BATMNU can use the environment to relay information back to the batch file. BATMNU will display an error message and return an EL=0 if you are not using the proper DOS version. 5.0 MOUSE SUPPORT ───────────────────────────────────────────────────────────────────────── When BATMNU is run, it checks for a mouse unless the 'x' parameter is found on the "window" line. This switch will cause BATMNU to skip the check for, and not use, the mouse. Once the mouse is detected, the mouse cursor will be set next to the first option. The delay you will observe after the menu is displayed and before the highlight bar appears is the mouse initializing and is normal. Options can be selected with the mouse by moving the cursor to the option line and clicking the left button. If the option is currently highlighted, BATMNU acts as if the hotkey was pressed. If not, only the highlight bar is moved. A second click will then select that option. The right mouse button acts like the ESCape key if the ~ option is used. 6.0 SCREEN SAVER ───────────────────────────────────────────────────────────────────────── If you use BATMNU for a shell, you will appreciate this feature. As a default, if the program does not see any key presses or mouse clicks in a 5 minute period, the screen will blank to protect your display. Only the cursor will show in the upper left hand corner. Press any key or mouse button to restore the screen. The pause time before blanking is set on the Window line with the 'p' parameter. 'p0' will disable this feature and the maximum pause before blanking is 30 minutes. Page 8 BATMNU v2.3 Warren Small (c) 1993 7.0 SHAREWARE INFORMATION ───────────────────────────────────────────────────────────────────────── This program is provided as "shareware". You are allowed to use it, free of charge, for a reasonable amount of time. If you find BATMNU to be useful, and continue to use it, a registration fee of $15 plus $2.50 postage and handling is required. A form is supplied with the archive file to register with (BATMNU23.REG). Paying this fee will encourage me to make improvements and/or correct problems for future versions. Registered users will receive notification of future releases and information on how the new version can be obtained. It will also give their ideas for improvements more value. 7.1 New Security Version ───────────────────────────────────────────────────────────────────────── If you have trouble with people messing with your menu files, BATMNU is now available in a version which will read specially encrypted files. The encryption scheme will not fool the CIA, but it should keep curious people from playing with your screen definition files. This new version, called BATMNU-E, has all of the features of the regular program and is completely compatible with it. It will read straight text files as well as the encypted ones. The program which does the encrypting (and decrypting for editing) is included with BATMNU-E and is very simple to use. If you want to receive BATMNU-E and the companion encypting program, the cost is $15. Use the form provided to register either or both. 7.2 New Utility Available ───────────────────────────────────────────────────────────────────────── WHY DO USERS LIKE A MENU? Because it makes their life easier. Now there is something to make the menu designer's life easier! Now creation of the menu is taken out of your hands and onto the screen! The BatMnu Menu Utility makes creating menus fast and painless. It gives instant feedback on what your new menus will look like. Debugging the most sophisticated menu is now a chore of the past. Seasoned BATMNU users quickly find they wouldn't be without this utility. It's out of beta testing now, and available to all registered BATMNU users. Why do you need this? LOOK! - See your menu as you are creating it. Instant feedback on changes and additions. The menu has the same look and feel it will have with BATMNU. - No need to remember which switch does what. - Menus are created just by filling in forms, answering a few Yes/No questions or selecting values from a list. - Automatic formatting of the menu file. - Menus can be edited even if they are inside batch files. - Up to 16 menus from the same file can be edited at one time. Page 9 BATMNU v2.3 Warren Small (c) 1993 - Rearranging options is as easy as highlighting the option and pressing a key. I know you will want the easiest way to create and edit menus for BATMNU. The BatMnu Menu Utility will make menu maintenance as easy as filling in a form. Use the registration form (BATMNU23.REG) to order BMU with your registered version of BATMNU. It's just $10 if you order with BATMNU. If you decide to order later you will have to pay an additional $2.50 for postage and handling. Get your copy today! 7.3 Bonus Program! ───────────────────────────────────────────────────────────────────────── Upon receipt of the registration fee, a disk will be sent with the current version plus the program SW-DIR.EXE. This program provides a scrolling file directory which can be used to choose a file and pass that filename to an application or use it in your batch file. Appearance options are similar to BATMNU. The program includes a QuickSearch feature which can quickly locate a file by name. DOS 3.3 or higher is required to use this program. Site licenses for BATMNU can be negotiated. Registered 1.X users can upgrade to 2.3 for $5 plus $2.50 for postage and handling. Feel free to give it to friends or upload the original archive file to other BBS's provided that no fee is charged for distribution and it is not modified in any way. Note to BBS Sysops: Please post this archive file as is, with all files included, and without changing the filename. 7.4 Bonus CD from JCS Marketing ───────────────────────────────────────────────────────────────────────── When you register BATMNU, you will receive a certificate redeemable for one issue of the "JCSM Shareware Collection" CD-ROM at half the normal cost. This disk is a collection of over 2300 shareware programs from nearly 1000 authors. The disk will cost $9.95 plus shipping and handling when the certificate accompanies your order. If you are already a subscriber, the certificate entitles you to receive your next CD at the reduced rate. Ver. 2.3 November 8, 1993 Warren Small CIS 71076,407 35 Benjamin Street GEnie W.SMALL Manchester, NH 03109 Prodigy RSJW31A Page 10 BATMNU v2.3 Warren Small (c) 1993 8.0 BATMNU History ───────────────────────────────────────────────────────────────────────── 1.1 2/02/90 First general release. 1.2 3/15/90 Options increased to 26. Added automatic hotkeys (A, p. 4) and hotkey choice by letter (p. 5). 1.3 4/22/91 Added numbered options (N, p. 3), menu frame choices (M#, p. 3), invisible hotkeys (INV, p. 2). 2.0 9/30/91 New option line format to start programs directly (p. 7). Added mouse support (p. 8), screen border color control (E#, p. 3), screen foreground color control (K#, p. 2), header and footer option (p. 5), shadow position control (S#, p. 3), letter and number separator (L, N, p. 3). 2.0a 1/31/92 Maintenance release fixing several bugs. Parameters now passed properly to programs started by BATMNU. Border color set properly. Default colors provided for header and footer. Header and footer documentation provided. 2.1 6/30/92 Added time/date options to header and footer (T#, D#, p. 6). Header and footer string length increased to 70 (p. 5). Default menu choice can be specified on command line (p. 1). Corrected action of menu with duplicate hotkeys (p. 5). Hotkey selection by letter favors uppercase match in option text (p. 4). Option string length increased to 50 for single column menus. Help line option added (p. 5). Background string fill added (K#string, p. 3). 2.1a 9/22/92 Environment variables can be used in title, header, footer, options and help (p. 2). ESC now clears help line (p. 5). 2.2 1/11/93 Right mouse button used as ESC (p. 8). Screen Saver added (P#, p. 8). Help now in external file (p. 12). 2.3 10/29/93 Added row/col positioning for menu (R#, C#, p. 4), option to remove wide margin around menu frame which increases title and option maximum length (p. 4), popup style header and footer (popup, p. 6), popup mode for the entire screen (popup, p. 4), and option value return through environment (V#[var], p. 4). Default 2 column menu now occurs at 14 instead of 12. Menu errors now return EL 127 instead of EL 0. Encryption version now available (p. 9). BatMnu Menu Utility now available (p. 9). Page 11 BATMNU v2.3 Warren Small (c) 1993 APPENDIX ───────────────────────────────────────────────────────────────────────── BATMNU 2.2 and higher use an external file for help information. The advantage to this is that it makes the program file smaller and it also allows a certain amount of customizing by the end user. The following is a guide to the structure of the help file, BATMNU.HLP. Each section begins with a header which contains a keyword, the window size, and the number of strings that will be placed in the window, enclosed in {}'s. {Keyword; top row; left col; bottom row; right col; # of strings} Example: {W_Colors; 12; 16; 18; 63; 4} The upper left corner for this window is at row 12, column 16, and the lower right is on row 18, at column 63. There are 4 strings of information that follow in this format: c or s; row; col; string Example: c; 12; 40;┤ WINDOW COLORS ├ s; 14; 19;f - Foreground Color b - Background Color s; 15; 19;t - Text Color o - Option Color s; 16; 19;h - Hotkey Color k - Screen Colors The letter beginning the line indicates whether it should be centered (c) at the position indicated or printed right at the position (s). The row and column position follows and then the string itself. If you decide you want to alter or add to the information in the file, here are a few things to remember. - The window should start at row 8 or more and end at row 22 or less unless you don't care if it covers the other text on the screen. In that instance, it can extend from row 1 to 25. The background text is not disturbed in any case. - The keyword cannot be altered. These are hard coded into BATMNU at present. If changed, the program would not be able to find the help section. - If the window position values are 0, as is the case for the 'Main' section, there is no window drawn and the program does not wait for the user to press a key. - Make sure that, if you add strings to a section, you adjust the window size accordingly. Likewise, position the strings so that they fit in the window. - Each parameter is separated by a semi-colon. A space is used only for readability. Leading spaces in a string are used. Page 12