APPLICATION NOTE #154 USING THE MICROSOFT MOUSE WITH XYWRITE III PLUS Rev. 03 The Microsoft Mouse, which is a product of Microsoft Corporation, is a hand-held pointing device that allows you to move the cursor quickly around the screen. This application note explains the procedure for using the Microsoft Mouse and a XYQUEST-developed mouse menu for XyWrite and XyWrite A La Carte Menus. PROGRAM REQUIREMENTS This procedure assumes you have installed a Microsoft Mouse according to the information in the Microsoft Mouse User's Guide, and installed XyWrite III Plus according to the procedures in the XyWrite III Plus Installation Guide. Additionally, you need the following files: MENU.COM MSMOUSE.MNU MSLAMOUS.MNU The first file is a utility program available on the program disks supplied with the mouse from Microsoft Corporation. It allows you to load special menu files, such as the ones provided by XYQUEST (see Note #1). The other two files, MSMOUSE.MNU and MSLAMOUS.MNU are mouse menus developed by XYQUEST specifically for the Microsoft Mouse. They are executable menu files which cannot be edited in XyWrite. MSMOUSE.MNU is for use with XyWrite with regular help files; MSLAMOUS.MNU is for use with the A La Carte Menus. Copies of MSMOUSE.MNU and MSLAMOUS.MNU are available upon request. Call or write Technical Services to obtain copies. INSTALLING THE XYWRITE MOUSE MENU To use the XyWrite mouse menu, be sure that MENU.COM and MSMOUSE.MNU or MSLAMOUS.MNU are on your working disk or in the XyWrite directory of your hard disk. To load a XyWrite mouse menu into memory, type one of the following commands at the DOS prompt before you go into XyWrite (see Notes #2 and #3). menu \path\msmouse or menu \path\mslamous where \path is the directory that contains the mouse menus. After you execute the command, the message "Menu installed" appears on the screen. You can now use your mouse while in XyWrite. To unload the mouse menu, type the following command at the DOS prompt (see Note #4). menu off Result: The message "Keyboard emulation off" appears on the screen. In order to load the menu automatically each time you boot your system, refer to the section "Automatic Startup." DESCRIPTION OF THE MS MOUSE MENUS The mouse menu program utilizes the mouse movements, the mouse buttons, and three menus (main, edit, mode). The functions of the buttons and movements are as follows. (See Notes #5, #6, #7.) Button Function Right button Call main menu Left button Execute (same as F9) Both buttons Escape Mouse Movement Function Left Cursor left Right Cursor right Up Cursor up Down Cursor down The main menu has the following options: 1. EDITS--calls the edit menu 2. MODES--calls the mode menu 3. HELP--calls the help screens 4. SAVE--saves a file on the screen 5. CHANGE WINDOWS--same as Alt_F10 6. DIRECTORY--displays a directory of the current drive and directory 7. DOS--exits to DOS from XyWrite 8. RETURN FROM DOS--returns from DOS to XyWrite 9. PRINT A FILE--prints the current file 10. CLEAR MENU--removes the menu from the screen (also see Note #6) 11. A LA CARTE MENU--calls the A La Carte Menu (available only in MSLAMOUS.MNU) The edit menu contains the following options: 1. BEGIN/END DEFINE (same as F1) 2. UNDELETE LAST (same as Alt_F3) 3. RELEASE DEFINE (same as F3) 4. DELETE DEFINE (same as Alt_F6) 5. COPY DEFINE (same as F7) 6. MOVE DEFINE (same as F8) 7. CLEAR MENU--clears menu The mode menu contains the following options: 1. MODE NORMAL--turns on mode normal (same as Ctrl_1) 2. MODE BOLD--turns on bold mode (same as Ctrl_2) 3. MODE UNDERLINE--turns on underline mode (same as Ctrl_3) 4. MODE REVERSE--turns on reverse mode (same as Ctrl_4) 5. MODE BOLD UNDERLINE--turns on bold underline mode (same as Ctrl_5) 6. MODE BOLD REVERSE--turns on bold reverse mode (same as Ctrl_6) 7. MODE SUPERSCRIPT--turns on superscript mode (same as Ctrl_7) 8. MODE SUBSCRIPT--turns on subscript mode (same as Ctrl_8) 9. CLEAR MENU--clears menu Please see Note #1 for information on customizing these menus or creating your own. USING A XYWRITE MOUSE MENU Once you have loaded the XyWrite mouse menu, you can use it to execute any of the functions listed in the menus. As an example, let's use it to display a word in bold mode. 1. Move the cursor to the beginning of the word you want in bold. You can use either the mouse or keyboard cursor keys to do this. 2. Press the right button on the mouse. Result: The XyWrite main menu appears in the middle of the screen. Using the mouse, you can highlight different menu options, but you cannot move the cursor outside of the menu borders. 3. Select the MODES option by moving the cursor to it and then clicking one of the mouse buttons. (See Note #6.) Result: The mode menu replaces the main menu. 4. Select the BOLD option by moving the cursor to it and then pressing one of the mouse buttons. Result: The menu clears from the screen, and all text from the current cursor position to the end of the file (or until the next mode command) appears in bold. 5. Move the cursor to the end of the word you want in bold. 6. Repeat steps 2 and 3. Result: The mode menu appears on the screen, with the MODE NORMAL option highlighted. 7. Press one of the mouse buttons. Result: The menu clears from the screen, and all text from the current cursor position to the end of the file (or until the next mode command) appears in normal. AUTOMATIC STARTUP If you would like the mouse menu automatically installed every time the computer is turned on, add one of the following commands to the AUTOEXEC.BAT file, before the command that starts the XyWrite editor: menu \path\msmouse or menu \path\mslamous where path is the directory that contains MSMOUSE.MNU or MSLAMOUS.MNU. If you want to unload the mouse menu after quitting XyWrite, add the following line to the AUTOEXEC.BAT file after the XyWrite editor: menu off Note #1 Customizing Menus. Neither MSMOUSE.MNU nor MSLAMOUS.MNU can be edited directly. It is necessary to make changes to a corresponding ASCII text file and then use Microsoft's mouse menu compiler, MAKEMENU.EXE, to make a new, executable mouse menu. For your convenience, the ASCII files used to create XyWrite's two mouse menus are included on the disk supplied by XYQUEST: MSMOUSE.DEF for MSMOUSE.MNU, and MSLAMOUS.DEF for MSLAMOUS.MNU. MAKEMENU.EXE and the Microsoft Mouse Programmer's Reference Manual are available from Microsoft Corporation. Note #2 Mouse Setup. When you ran the Microsoft mouse setup program, you were given the option of automatically loading the mouse driver each time you start DOS. If you did not select automatic loading, you must issue the MOUSE command before you load the MSMOUSE or the MSLAMOUS menu. For example: mouse menu msmouse Note #3 Memory Requirement. MSMOUSE.MNU and MSLAMOUS.MNU use approximately 1.5K of memory. Note #4 Unloading Mouse Menu. The mouse menu runs independently of XyWrite and may conflict with other software packages. Therefore, you should turn off the XyWrite mouse menu when you exit XyWrite. Note #5 IBM.KBD. The XyWrite mouse menus assume you are using the standard XyWrite keyboard file, IBM.KBD. If you are using a customized keyboard, you may have to modify the menus (see Note #1). For example, the mouse menu assumes the Execute function is mapped to F9. If you remapped the keyboard and assigned the Move function to F9, XyWrite will try to execute a Move when you press the left button on the mouse. Note #6 Removing Menu. If you press both mouse keys simultaneously while a menu is on the screen, the menu will be removed and no action will be executed. Note #7 Linear Cursor Movement. For smoother cursor movement on the screen, assign the linear cursor functions (LL, LR, LU, LD) to the cursor keys in the XyWrite keyboard table. Remap all positions of the cursor keys that are not used for other functions (e.g., Shift_ÿ1A and Shift_ are used for column tables). ##