Category : Utilities for DOS and Windows Machines
Archive   : SHRCM874.ZIP
Filename : SHARCMNU.DOC

MOUSE MENU FOR SHARC 8.70
(for use with LogiTech 3-Button Mouse)


-=[ Jay Merrill ]=-
San Francisco, California
22 October 1988
[CompuServe: 72411,2442]




This is a 3-button mouse menu for use with Jim Derr's SHARC archive file
manager (version 8.70). I have included both the compiled mouse driver
(SHARC.MNU) and the text file (SHARC.DEF) which created it to facilitate
modifications by other users.

The OPENING SCREEN MENU. While SHARC's opening screen/file windows are
displayed, pressing the MIDDLE button will display a legend on the screen
showing the mouse button defintions (for when NO menus are active -- see
below) and, below that, the opening screen functions keys, which will have
become mouse-selectable. Pressing any ONE button while this menu is showing
will perform the bottom-line function that is highlighted. Pressing any TWO
buttons simultaneously when the menu is showing will CANCEL the menu and
return to SHARC's original screen.

The MAIN MENU is a modification of SHARC's own help screen, set up for mouse
control. Once you have called up an archive from the file window and an
active "archive" screen is being displayed, pressing the MIDDLE button will
pop up the MAIN MENU, where you may select functions by pressing ANY ONE
button when your choice is highlighted. Again, ANY TWO buttons pressed simul-
taneously will restore the screen that was active before the menu appeared.

A MOUSE MENU SHOULD BE CANCELLED BEFORE TRYING TO USE ANY OF SHARC'S OWN KEYS.
(If you enter a SHARC command from the keyboard while a mouse menu IS dis-
played, nothing will happen until the menu is cancelled. Then, the SHARC
command will be performed immediately (which might be startling and not what
you had in mind at the time).

At any time that a mouse menu is NOT displayed, the buttons are defined as

Left ESCAPE Left/Right TAG FILES
Middle MENU Left/Middle PAGE UP
Right ENTER Right/Middle PAGE DOWN
All Three RESPOND "YES"

Again, you can pop up a legend for these definitions by pressing the MIDDLE
button whenever the opening screen is visible. There is not enough room on
this menu to warn you that these definitions are NOT IN EFFECT until the menu
is erased by pressing TWO BUTTONS. When mouse menus are present, a single
button is interpreted as ENTER, two (or all three) buttons as ESCAPE -- so
even the left button (normally ESCAPE) will act as ENTER until the menu is
cancelled. This can cause unwanted results, but it is a default set by
LogiTech and I can find no way around it: Button actions are not definable
when menus are showing.)

NOTE: I use my mouse left-handed. If you want a more logical, right-handed
configuration, just switch the order of the labels in the BEGIN and CHORDS
statements in the MOUSE.DEF file (and recompile using LogiTech's NEWMENU.EXE).
The label definitions do not have to be altered. Logi-Tech's menu driver
interprets the labels assigned in the BEGIN/CHORDS statements in strict order
(i.e., the first BEGIN label ALWAYS defines the left button, the second the
middle button, the third the right), regardless of what the label is named.
So, in the BEGIN statement, just rename LB to RB and RB to LB; in the CHORDS
statement, rename LMB to MRB and MRB to LMB if you want to use your right
index finger for "ENTER" and the two nearest buttons for "PAGE DOWN."
LogiTech's manual implies that recompiling the driver using a "switch" will
effect the same result (i.e., "NEWMENU SHARC /RML"), although I haven't tested
it.


SHARC and LogiTech are trademarks of their owners.

These files are offered to the public domain. No fee may be charged and no
guarantee or warranty is offered or implied for their use.