PCMenu V. 1.4 - A utility for Amiga users with PC habits. If you like the way IBM PC programs use pulldown menus or if you would just like to be able to browse through menus using the key board, then PCMenu is for you. CLI Usage: PCMenu [?][-q][+q][-kxx][-d][-L][quiet] -q Select qualifier to use with menu activation key. e.g. -qR. +q Select qualifier to use with first letter matching. -k Select menu activation key. Use the hex code. Default is Help. -d Force mouse to move to disabled items. Defaults to off. -L Allow selecting of items by first letter without pressing Return. quiet Do not show signon message. This is only on registered versions. To obtain a copy with this option enabled, send $10 to the address at the end of this documentation. PCMenu detaches from the CLI, so there is no need to "Run PCMenu". Type PCMenu again or double click on its icon again to remove PCMenu. Workbench Usage: PCMenu can be started from an icon and the options may be set in the ToolTypes gadget. See below for details. ************************************************************************ WHAT THIS PROGRAM DOES PCMenu, when run with the defaults, will let you activate the menu bar by pressing Amiga-Help. You can then use the arrow keys to move to your desired menu item and then press Return to make your selection. You may also press Shift-Return to make extended selections. Turn off the menu bar by pressing ESCape or Amiga-Help again. You may at any time grab the mouse and take over control. First Letter Matching: If you wish, you may activate a menu by pressing a qualifier key and the first letter of a menu. To use this feature you must start PCMenu with the +q option. +qA would mean that when you press Alternate-B, for example, the first menu that begins with the letter B will become active. If no menu begins with the selected letter, it will be passed through. Deactivate the menu bar by pressing ESCape. Item Selecting: After activating the menu bar, you may use the arrow keys or, you may highlight menu items or subitems by pressing the first letter in the item or subitem's name. Select the item by pressing Return. Press Shift-Return to make extended selections. You may combine "highlighting" and "selecting with letter matching" by using the -L option. Selection Notes: 1. Pressing a letter key will highlight the first menu item that matches. If there are more matching menu items, repeated pressing will highlight each. See the -L option below for immediate selecting. 2. Menu items will be checked for matches unless the highlighted menu item has subitems in which case only the subitems will be checked. 3. Preceding blanks in menu items will be skipped. This means that you cannot select items by pressing the space bar. 4. If a subitem has more than one subitem displayed horizontally, you may need to select subitems that are to the right by pressing the down arrow. Pressing the right arrow while a subitem is highlighted will activate the next menu. 5. PCMenu will remember which item and subitem was highlighted last and will automatically go to that selection the next time. ************************************************************************ CHANGING THE MENU ACTIVATING KEY AND QUALIFIER KEYS From the CLI: You may change the menu activation key with the -kxx option. Replace xx with the hex code for the desired key. For Example: PCMenu -k59 will use Amiga-F10. Some of the key codes are listed below. You may change the qualifiers that will be used with this key. For example: PCMenu -qSR will use Shift-Right_Amiga-Help to activate the menus. The qualifiers are listed below. From Workbench: To change the key used to activate the menus, enter in the ToolTypes gadget: MENU KEY=xx Replace xx with the hex key code. To change the qualifier used with the menu key to (for example) Shift-Alternate, enter in the ToolTypes gadget: MENU QUALIFIER=SHIFT+ALTERNATE These are case sensitive! They must be all upper case. The qualifiers are listed below. ************************************************************************ CHANGING "FIRST LETTER MATCHING" QUALIFIER From the CLI: You may set the qualifiers to be used with the "first letter matching" feature. Use the "+q" with the desired qualifiers. For example: PCMenu +qCE will let you select a menu by pressing Control-Amiga and the first letter of the desired menu. Note that either Amiga key may be used in this case. From Workbench: To enable menu letter matching with (for example) the Alternate key, enter in the ToolTypes gadget: LETTER MATCHING QUALIFIER=ALTERNATE These are case sensitive! They must be all upper case. ************************************************************************ QUIET AND DISABLED ITEM OPTIONS You may prevent the opening information window from being displayed and allow the mouse to move to disabled items. From the CLI: Prevent the opening window with the "quiet" option. Allow the mouse to move to disabled items with the -d option. For example: PCMenu -d quiet From the Workbench: Enter in the ToolTypes gadget of the icon: DISABLED OK=TRUE Allows mouse to move to disabled items. DISABLED OK=FALSE Does not allow it. QUIET=TRUE No opening window. QUIET=FALSE Allows opening window. Note that the quiet option is available only to registered users. ************************************************************************ COMBINING SELECTING AND HIGHLIGHTING WITH LETTER MATCHING Most PC programs allow you to highlight and select item by pressing a letter. PCMenu normally allows only the highlighting of item when a key is pressed. You then need to press to select it. You may automatically select it without pressing by using the -L option. ************************************************************************ THE QUALIFIERS USED From the CLI: A - Alternate S - Shift C - Control L - Left Amiga R - Right Amiga E - Either Amiga N - Numeric keypad From Workbench: These are the allowable qualifier keywords entered in ToolTypes: SHIFT Either shift key CONTROL ALTERNATE Either alternate key LEFT AMIGA AKA the C= key RIGHT AMIGA EITHER AMIGA NUMERIC The Left Amiga key on some 500s and 2000s is the C= key. If you use a numeric keypad key, you must use the -qN or NUMERIC option. ************************************************************************ Examples: PCMenu Uses defaults PCMenu -qSR Uses Shift-Right_Amiga with the Help key. PCMenu -qCE +qSR Uses Control-Left_Amiga or Control-Right_Amiga with the Help key and Shift-Right_Amiga with a letter key to select a menu by its first letter. PCMenu -qN -k4a quiet Uses the numeric pad "-" instead of the Help key. The signon window is not displayed. PCMenu +qE -L Use either Amiga key for menu letter matching and immediately select an item when you press a letter that matches an item. ************************************************************************ Some of the hex key codes are: Numeric Pad 0 0f Numeric Pad 1 1d Numeric Pad 2 1e Numeric Pad 3 1f Numeric Pad 4 2d Numeric Pad 5 2e Numeric Pad 6 2f Numeric Pad 7 3d Numeric Pad 8 3e Numeric Pad 9 3f Numeric Pad . 3c Numeric Pad - 4a Numeric Pad Enter 43 Numeric Pad ( 5a Numeric Pad ) 5b Numeric Pad / 5c Numeric Pad * 5d Numeric Pad + 5e Backslash 0d Backspace 41 Tab 42 Return 44 Esc 45 Delete 46 Up arrow 4c Down arrow 4d Right arrow 4e Left arrow 4f Help 5f Function Key 1 50 Function Key 2 51 Function Key 3 52 Function Key 4 53 Function Key 5 54 Function Key 6 55 Function Key 7 56 Function Key 8 57 Function Key 9 58 Function Key 10 59 ************************************************************************ Notes: This program may not function properly when MachIII is running with the option MTM (Mouse To Menu) on. If you use the option +qR or +qE, keyboard equivalents and keyboard menu shortcuts such as Amiga-C will not work if a menu begins with that letter. That means that you won't be able to use Right-Amiga-X to clear a string gadget if a menu begins with X. If this is a problem, a better choice might be +qA or +qSR or +qL. ************************************************************************ PCMenu is shareware. If you use this program you should send $10 to: Polyglot Software 884 W. Melrose Ln Boise, ID 83706 If a newer version is available, it will be sent to you. Registered versions have the "quiet" option enabled. PCMenu - Copyright 1991 by Brian Moats. Also available: PCMenuSpeak - This is the same program as PCMenu but all menu items are spoken as they are highlighted. Highly useful for visually impaired users. $10.00. Any questions or problems should be directed to: Brian Moats Polyglot Software 884 W. Melrose Ln. Boise, ID 83706 (208) 336-4583