Programmer 7500

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

/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / TPMENU50.ZIP / TMENU.DOC < prev

Wrap

Text File | 1990-03-28 | 30.3 KB | 768 lines

CB ╔═══════════════════╦════════════════════╦══════════════╗ ║ Written by ║ Microsoft/Logitech ║ TPMENU50.ZIPP║ ║ ║ Mouse Menus ║ ║ ║ ║ for ║ Version 0 ║ ║ Gerald Piosenka ║ TURBO PASCAL 5.0 ║ 21 Feb 90 ║ ╠═══════════════════╩════════════════════╩══════════════╣ ║ TPMENU50.ZIP is released in the public domain for ║ ║ non-commercial use only. For commercial application ║ ║ you may contact me for a license at; ║ ║ ║ ║ 7320 E. Camino Santo ║ ║ Scottsdale, Az 85260 ║ ╠═══════════════════════════════════════════════════════╣ ║ I will support users with questions, changes or ║ ║ problems on a hobby basis only. If needed you can ║ ║ leave a message with the Toolshop BBS, 602-279-2673 ║ ╠═══════════════════════════════════════════════════════╣ ║ Please retain the name of the File - TPMENU50.ZIP ║ ║ and this message if you distribute the file to ║ ║ others. ║ ╠═══════════════════════════════════════════════════════╣ ║ The Turbo Pascal 5 files in the archived file are ║ ║ TCMENU.Def - source code for color menus ║ ║ TMENU.Def - source code for monochrome menus ║ ║ TCMENU-L.Mnu- Logitech compiled color menus ║ ║ TMENU-L.Mnu - Logitech compiled monochrome menus ║ ║ TCMENU-M.Mnu- Microsoft compiled color menus ║ ║ TMENU-M.Mnu- Microsoft compiled monochrome menus ║ ║ TMENU.Doc - Documentation ║ ╚═══════════════════════════════════════════════════════╝ 1.0 Program Selection Compiled MNU files are provided for either Logitech or Microsoft for use in either color or Monochrome systems. Select the appropriate menu based on your mouse type and video system. I have included the mouse source definition files for those users that may choose to customize them for their specific use.If you do alter the source files please do not use them to replace the present source files in this package. Otherwise it will be very difficult to answer questions or provide help. 2.0 Turbo Configuration The menu system was developed with Turbo Pascal 5.0 in its standard configuration. Because the menu systems looks for specific text on the screen in order to popup the correct menu it may not work if you have significantly changed the default settings If you have problems try reverting to Turbo Pascal's original configuration. 3.0 Program Setup Since the mouse menus are terminate and stay resident programs you need to load the appropriate menu before you enter Turbo Pascal. First make sure your mouse driver is installed. To load the menu you will need to invoke the Microsoft or Logitech Menu.com program. In my system I have the menu.com program and the compiled menus in a directory C:\MOUSE and the mouse driver is loaded by the autoexec.bat file at startup. I use a BAT file to load the menu for Turbo Pascal , to switch to the directory TP which holds the Turbo program and to remove the menu from operation when Turbo is finished. The BAT file called T.BAT appears as C:\MOUSE\MENU C:\MOUSE\TCMENU-L CD C:\TP TURBO C:\MOUSE\MENU OFF The menus were originally written for the Logitech three button mouse. The Microsoft is a two button mouse so in using the program and in reading this manual you have to make a mental translation if you are a Microsoft two button mouse user. The table below defines the translation Logitech Microsoft Left Button Left Button Middle Button Right Button Right Button Both Buttons I purposely wrote the menus without the use of chords so that it will work for both the Microsoft and Logitech mouse systems. PS I have tried this on a system using a Mouse Systems bus mouse and found that it worked to my surprise. However the mouse buttons were strange. The left button worked correctly but you have to use chord combinations to simulate the Logitech middle and right button effects. 4.0 Operation Turbo starts with its normal edit screen with the FILE entry highlighted in the top menu. At this time the mouse is programmed such that; LB (left button)types Enter MB types ESC RB types F6 (switches between edit -make or watch window) Moving the mouse is the same as using the arrow keys. In this configuration you can move the mouse to highlight any entry in the top menu. Then press the left button to select the entry. If a submenu exits it will appear. Move the mouse vertically within the submenu and click the left button to select the desired option. Note clicking the middle button acts the same as hitting the escape key and is usually used to cancel an operation. As an example use the mouse to highlight the FILE option and click the left button. The File submenu appears. Move the mouse vertically to select the Load option and click the left button Turbo generates the prompt window with *.Pas as the file mask. Click the left button (types Enter) and Turbo will display a directory of your *.pas source programs. Move the mouse to place the highlight on the desired file and click the left mouse button. Turbo loads the file and makes the EDIT window active. Simple right!. 4.1 Edit Window Menus When the edit window is active the mouse is programmed as defined in section 4.0 except clicking the left button will popup the main menu shown below: ╔════════╦═════════╦═════════╦════════╦═══════╦═════════╦═════════╦═══════╗ ║ MISC ║ FILE ║ EDIT ║ SCREEN║ RUN ║ COMPILE ║ DEBUG/BR║ WATCH ║ ╠════════╬═════════╬═════════╬════════╬═══════╬═════════╬═════════╬═══════╣ ║ Cancel ║ Load ║ Find M ║ Zoom ║ Run ║ to OBJ ║ Eval ║ Add ║ ║ Bar ║ Pick ║ Set M ║ Switch ║ Trace ║ Make ║ Stack ║ Del ║ ║ Dir ║ New ║ Block ║ User ║ Step ║ Link ║ Find F ║ Edit ║ ║ Misc ║ Save ║ Search ║ Refresh║ to Cur║ Build ║ Tog BP ║ Remov ║ ║ Shell ║ Write to║ Replace ║ Edit ║ Reset ║ Primary ║ Clr BP ║ ║ ║ Quit ║ Chg Dir ║ Research║ ║ ║ Info ║ View BP ║ ║ ╚════════╩═════════╩═════════╩════════╩═══════╩═════════╩═════════╩═══════╝ This menu is similar to but not identical to Turbo's main menu. Move the mouse to highlight the desired entry and click the left mouse button to select the option. Sections 4.1.1 to 4.1.12 define the entries in the above menu. 4.1.1 Cancel Selecting this option will cancel the menu and return you to the Edit window. Note when Turbo activates the Edit window the mouse may be in its "slow" mode. Typically when the edit window is active you want a "fast" mouse. Poping up the above menu and selecting Cancel reprograms the mouse to be "fast". This is particularly useful if you are doing a lot of editing and want to be able to move around the screen quickly. 4.1.2 Bar Selecting this option is the same as typing F10 - that is you will be placed in Turbo's main menu. The mouse is reprogrammed as described in paragraph 4.0. Use the mouse to highlight and select the desired option 4.1.3 Dir Selecting this option is the same as selecting Turbo's Directory command. Turbo will prompt with a file mask of *.*. Press the mouse left button (types Enter) to use this mask or type in a new mask and hit enter. When the directory list appears move the mouse to highlight the selected file and press enter to select it. You can also press the middle mouse button to Escape without selecting a file. 4.1.4 Misc Selecting this option will cause the menu shown below to appear. These represent a collection of miscellaneous commands which I have found I seldom use, but I included them so you won't have to run around looking for the Turbo manual to find out what un Godly combination of keys you need to press. ╔═════════════════════════════════════════════╗ ║ MISCELLANEOUS COMMANDS ║ ╠═════════════════════════════════════════════╣ ║ Cancel Menu Toggle AutoIndent ║ ║ Restore Line Toggle Tab Mode ║ ║ Pair Match Left Pair Match Right ║ ║ Abort Operation Toggle Opt Fill Mode ║ ╚═════════════════════════════════════════════╝ Sections 4.1.4.1. through 4.1.4.8 define the menu selections 4.1.4.1 Cancel Menu Selecting this option cancels the menu and returns you to the edit window. 4.1.4.2 Restore Line Selecting this option will restore the last line you edited to its original form provided you have not left the line. 4.1.4.3 Toggle AutoIndent Toggles the auto indent mode of the editor. 4.1.4.4 Toggle Tab Mode Toggles the editor Tab mode on /off 4.1.4.5 Pair Match Left Locates the mate to a paired delimeter marked by the cursor. Be sure to set the cursor position in the edit window before you activate the menu and select this option. 4.1.4.6 Pair Match Right Same as 4.1.4.5 above except searches backward from a right delimiter. 4.1.4.7 Abort Operation Causes Turbo to abort a current operation such as a search which is in process. 4.1.4.8 Toggle Opt Fill Mode Toggles the editors optimal fill mode on or off 4.1.5 Shell This option is the same as selecting Turbo's shell option from its File submenu. Turbo creates a DOS Shell. You can exit the shell and return to Turbo by clicking the left mouse button when you are in the shell. The menu shown below will appear; ╔═════════════════════╗ ║ Return to Turbo ? ║ ╠══════════╦══════════╣ ║ Yes ║ No ║ ╚══════════╩══════════╝ Selecting Yes from the menu will exit the shell and return you to Turbo Selecting No will cancel the menu and you will remain in the shell. Note that if you run any programs while in the shell that use the mouse you must reload the mouse menu since you destroyed the mouse state. To do this follow the concept described in paragraph 2.0. You will have to type EXIT to leave the shell. After that the menus should function properly. I have recently found that on some PS/2 models running DOS 4.0 the menu does not enable you to return to Turbo. It seems once outside turbo the mouse program can not stuff data into the keyboard buffer to simulate key strokes. If you have this problem just type Exit to return to Turbo. 4.1.6 Quit This is the same as selecting Quit from Turbo's File menu. The program will terminate. Note unless you unload the menu with Menu OFF it will remain in memory. 4.1.7 File SubMenus All the selections under the FILE heading of the mouse popup menu function identically to those in Turbo's File submenu. 4.1.8 Edit SubMenus Options under the EDIT heading are described in paragraphs 4.1.8.1 to 4.1.8.6 This grouping primarily covers various commands which impact the active edit window. 4.1.8.1 Find M (Find Marker) Selecting this option will popup the menu shown below; ╔════════════════════════════════════════════╗ ║ Cancel Menu Marker Number 0 1 2 3 ║ ╚════════════════════════════════════════════╝ This menu is used to select the marker number you wish to find. If you do not want to find a marker select cancel menu to return to the edit window. 4.1.8.2 Set M (Set Marker) Selecting this option will popup the menu shown below; ╔════════════════════════════════════════════╗ ║ Cancel Menu Marker Number 0 1 2 3 ║ ╚════════════════════════════════════════════╝ Selecting a marker number will set a marker in the Edit window at the text location currently under the cursor. Be sure to place the cursor in the desired position before you select this menu. If you forgot, select cancel menu to return to the edit window, then set the cursor to the desired position and repeat the process. 4.1.8.3 Block Selecting this option pops up the menu shown below; ╔═════════════════════════════════════════════════════════════════════╗ ║ BLOCK COMMANDS ║ ╠═════════════════════════════════════════════════════════════════════╣ ║ Cancel Menu Copy Disk Read Print Set Start Indent ║ ║ Hide/Show Move Disk Write Delete Set End Outdent ║ ╚═════════════════════════════════════════════════════════════════════╝ Paragraphs 4.1.8.3.1 to 4.1.8.3.12 define the menu options 4.1.8.3.1 Cancel Menu Cancels the menu and returns you to the edit window 4.1.8.3.2 Hide/Show Toggles the highlighting of the block then returns you to the Edit window. 4.1.8.3.3 Copy Copies the defined block to the current cursor location. Be sure to set the cursor position before you select this option. 4.1.8.3.4 Move Moves the currently defined block from its present position to to the current cursor position. Again be sure to place the cursor in the appropriate position in the Edit window PRIOR to activating this option. 4.1.8.3.5 Disk Read Selecting this option causes Turbo to prompt for a file name from which to fetch the block. Type the filename and Turbo will read the text file and place the data as a block at the current position of the cursor within the edit window. Again be sure to set the cursor position in the Edit window prior to selecting this option. 4.1.8.3.6 Disk Write Selecting this option will cause Turbo to prompt for a filename. Enter the filename and Turbo will copy the currently defined block to the named file. 4.1.8.3.7 Print Selecting this option will cause Turbo to print the currently defined block. If no block is defined then the entire file is printed. 4.1.8.3.8 Delete Block Careful with this one, if you select it the currently defined block will be deleted. To protect you from an accident the menu system pops up the window shown below to make sure you want to delete the block; ╔═════════════════════╗ ║ Delete Block ? ║ ╠══════════╦══════════╣ ║ Yes ║ No ║ ╚══════════╩══════════╝ Selecting YES will cause the block to be deleted. Selecting no will return you to the edit window without deleting the block. 4.1.8.3.9 Set Start Selecting this option will mark the start of a block to begin at the current position of the cursor in the edit window. Again be sure to set the desired cursor position before you select this option. 4.1.8.3.10 Set End Selecting this option defines the end of a block to be at the current position of the cursor in the Edit window. 4.1.8.3.11 Indent Selecting this option indents the currently defined block one character to the right in the Edit window. 4.1.8.3.12 Outdent Selecting this option moves the currently defined block one position to the left in the edit window. 4.1.8.4 Search Selecting search causes Turbo to prompt for the text to find. If the search command has been used previously in the session Turbo prompts with the last text stream searched for. If you want to search for this text again simply hit enter or click the left mouse button . If you want to search for a new text string use the edit keys to enter the new string. Note moving the mouse horizontally can be used to erase old text then type in the new. When you have entered the desired text hit enter or click the left mouse button. Next Turbo will prompt for the options for the search. If you have searched previously the old options will appear. You can use the old options, type in new ones or add to the old ones. Again moving the mouse will delete the old options. The mouse can be used to select the new options, just click the left mouse button and the menu shown below pops up; ╔═════════════════════════════════════════════════════════════════════╗ ║ SEARCH OPTIONS ║ ╠═════════════════════════════════════════════════════════════════════╣ ║ Cancel Menu Global Within Block No case Execute ║ ║ Cancel Search Backward Whole word No Prompt ║ ╚═════════════════════════════════════════════════════════════════════╝ Selecting Cancel Menu removes the options menu. Selecting Cancel Search will terminate the search command and return you to the Edit window. Selecting global will remove the Search menu and type a G in the options list. If you press the left mouse button again the Search Options menu will reappear and you can select additional options. The search does not commence until you select Execute. The other options of the Search Options menu are self evident and are the same as the Turbo C keyboard equivalents. 4.1.8.5 Replace Selecting this option executes Turbo's replace command. This command functions like the Search command except that you are prompted to provide a text stream used to replace the search text string. The mouse menu system provides the same option menu as described for the Search command. If you keep the prompt option Turbo highlights the matched find text and prompts you to type Yes or No to replace the text. Click the left mouse button in this situation and the menu shown below appears; ╔═══════════════════════════════════════════╗ ║ Substitute Ignore Abort Search ║ ╚═══════════════════════════════════════════╝ Selecting Substitute from the menu will cause the search text to be replaced. Selecting Ignore will not replace the search text. Selecting Abort will cause the search text not to be replaced and will terminate the replace command. 4.1.8.6 Re-Search Selecting this option will cause Turbo to re-execute the last search or replace command using the options set during that command. 4.1.9 Screen Commands The screen commands have to do with the selection of the active window or the shape of the active window. Selecting switch will cause Turbo to switch from the presently active window (edit or message/watch) to the alternate active window (message/watch or Edit). Selecting the Zoom option will cause the currently active window to occupy the full screen. Selecting the User option will cause Turbo to display the user output screen. Selecting Refresh causes Turbo to execute a screen refresh. Selecting Edit makes the Edit window active. Note that when the Watch window is active, the mouse is programmed to pop up the menu shown below when the left mouse button is pressed. ╔═════════════════════════════════════╗ ║ WATCH SCREEN MENU ║ ╠═════════════════════════════════════╣ ║ Cancel Menu Main Bar Menu ║ ║ Add Watch Delete Watch ║ ║ Edit Watch Remove All Watches ║ ║ Get Help Go to Edit Screen ║ ╚═════════════════════════════════════╝ Selecting Cancel will cancel the menu and return you to the Watch window. Selecting Main Bar Menu will put you in Turbo's main menu. Selecting Add Watch will cause Turbo to popup a prompt window for you to enter the watch variable name. Delete watch will cause the currently highlighted watch variable to be deleted from the watch window. Selecting Edit Watch causes Turbo to popup a prompt window with the currently highlighted variable in the watch window available to be edited. Remove All Watches will delete all watch variables from the watch window. Get Help will causes Turbo C to pop up a help window. Selecting the Go To Edit option will make Edit the active window. When the watch window is active you can move the mouse horizontally to highlight a desired line in the watch window for the purpose of editing or deleting the watch. You can click the right mouse button (switch) to toggle between the edit and watch windows. 4.1.10 Run Commands The options under the Run heading of the mouse menu are the same as those under Turbo's run submenu. 4.1.11 Compile Commands The options under the Compile heading of the mouse menu are the same as those under Turbo's compile submenu except that the two least used options are not provided. 4.1.11 Debug/Br Commands I have deviated a little here from Turbo's grouping of menus and submenus in order to make the main menu have less lines. The first three entries Evaluate,Stack and Find F are the same as the Turbo submenu selections under Debug. The remaining three options Tog Bp (toggle breakpoint), Clr Bp,(Clear breakpoint) and View Bp (view breakpoint) are the same as the submenu selection under Turbo's Break/watch heading. 4.1.12 Watch Commands These options are the same as those of Turbo's Break/watch heading. 4.2 Other Menus Various mouse menus will appear in response to your clicking of the left mouse button depending upon certain prompt screens generated by Turbo. These special menus are defined in paragraphs 4.2.1 through 4.2.5. 4.2.1 Save Prompt Menu On certain occasions Turbo will prompt you is you wish to save the file currently in the editor. This happens if a have edited a file and then tell Turbo to load a new file. When the prompt occurs press the left mouse button and the menu shown below will appear; ╔═════════════════════╗ ║ Save Current File ? ║ ╠══════════╦══════════╣ ║ Yes ║ No ║ ╚══════════╩══════════╝ Select YES to save the current file or No not to save the file. 4.2.2 Rebuild Prompt Turbo will sometimes prompt you if you wish to rebuild a file before you run or compile it. When this occurs press the left mouse button and the menu below appears; ╔═════════════════════╗ ║ Rebuild ? ║ ╠══════════╦══════════╣ ║ Yes ║ No ║ ╚══════════╩══════════╝ Select Yes to rebuild the file. 4.2.3 Disk Not Ready Prompt When a disk drive fails to respond Turbo prompts you with a message and asks to abort or retry. Press the left mouse button for the menu shown below; ╔═════════════════════╗ ║ Disk not ready ║ ╠══════════╦══════════╣ ║ Abort ║ Retry ║ ╚══════════╩══════════╝ Select either Abort or Retry. 4.2.4 Overwrite Prompt When you specify to write to a file which already exists Turbo prompts to overwrite the file. Click the left mouse button for the menu shown below; ╔═════════════════════╗ ║ Overwrite File ? ║ ╠══════════╦══════════╣ ║ Yes ║ No ║ ╚══════════╩══════════╝ Select yes to overwrite, no to abort operation. 4.2.5 Help Menu When a Turbo Help screen is displayed you can press the left mouse button to produce the menu shown below. This menu appears above the help window. ╔══════════════════════════════════════════════════╗ ║ Cancel Menu Page Up Cancel Help ║ ║ Help Index Page Down Keyword ║ ╚══════════════════════════════════════════════════╝ Selecting Cancel Menu cancels the help menu. Page Up or Page down move forward or backward through the help windows. Cancel Help clears the help window and you return to the previous active window. Selecting Help Index causes Turbo to display the Help Index. Move the mouse to select the desired topic and press the left mouse button to generate the associated help screen. Certain help screens have keywords in the text. Move the mouse to highlight the desired keyword and press the left mouse button. This will cause Turbo to show the related help window for the selected keyword. 4.2.6 Compiler Message Window When the program you have tried to run or compile has errors Turbo Pascal opens a message window with appropriate status data and a prompt to press any key to continue. To remove this window simply click the mouse left button. This should take you directly to Turbo's message window. 4.2.7 Message Window You can make the message window active as described in paragraph 4.2.7 or by pressing the mouse right button from the normal edit screen. Normally the Message window contains error and warning messages which you scan and then correct by making the edit window active and changing the source code. While in the Message window move the mouse vertically to select the desired error message to operate on. Then click the mouse left button. This will place you in the edit screen with the cursor on the line referenced by the error message. Correct the errors as required then click the mouse right button to return to the message window to select another error message to operate on. Continue till all errors arew fixed then select the next desired Turbo command. 5.0 Operational Note If you are somewhat use to using Turbo without the mouse you will initially have a tendency to mix keyboard commands with mouse commands. Because most of the mouse actions are predicated on looking at the Turbo screen for information as to how the mouse should act the mixed use of the mouse and the key commands should not cause much of a problem. If you do get a strange situation it can generally be resolved by clicking the mouse left button a few times. If that doesn't work try to make the edit window active then click the left button once or twice this should just about always straighten things out. Even if you are proficient at using the keyboard commands I have found that using the mouse to move around the Edit window is much faster than using the arrows keys. This should consideably speed up the edit process which seems to be where I spend most of my time. 6.0 Parting Note I hope these menus help make the use of Turbo a little easier. If you feel that this program is of some value send me $ 500.00 (fat chance) or better yet make a $ 5.00 contribution to your favorite charity.! Good Luck . 7.0 Another Parting Note For some reason more and more people seem to be putting legal disclaimers on public domain programs. So just in case there's a good reason for it here it is; The programs provided as part of this package are made available for use at your own risk. The author assumes no responsibility for the accurrary of their operation nor for any consequences which result from their use.