home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 600-699 / ff624.lha / PCMenu / PCMenu.doc < prev    next >
Text File  |  1992-03-21  |  10KB  |  329 lines
  1. PCMenu V. 1.5 - A utility for Amiga users with PC habits. 03-07-92
  2.  
  3.   If you like the way IBM PC programs use pulldown menus or if you
  4.   would just like to be able to browse through menus using the key
  5.   board, then PCMenu is for you.
  6.  
  7. CLI Usage:
  8.  
  9.   PCMenu [?][-q][+q][-kxx][-d][-L][quiet]
  10.  
  11.   -q     Select qualifier to use with menu activation key. e.g. -qR.
  12.   +q     Select qualifier to use with first letter matching.
  13.   -k     Select menu activation key. Use the hex code. Default is Help.
  14.   -d     Force mouse to move to disabled items. Defaults to off.
  15.   -L     Allow selecting of items by first letter without pressing Return.
  16.   quiet  Do not show signon message. This is only on registered versions.
  17.          To obtain a copy with this option enabled, send $10 to the
  18.          address at the end of this documentation.
  19.  
  20.   PCMenu detaches from the CLI, so there is no need to "Run PCMenu".
  21.   Type PCMenu again or double click on its icon again to remove PCMenu.
  22.  
  23.   Note: The "Accelerator" in "Prefs/Input" of 2.04 must be turned off!
  24.  
  25. Workbench Usage:
  26.  
  27.   PCMenu can be started from an icon and the options may be set in the
  28.   ToolTypes gadget. See below for details.
  29.  
  30.  
  31. ========================================================================
  32.  
  33. WHAT THIS PROGRAM DOES
  34.  
  35.   PCMenu, when run with the defaults, will let you activate the menu
  36.   bar by pressing Amiga-Help. You can then use the arrow keys to move to
  37.   your desired menu item and then press Return to make your selection. You
  38.   may also press Shift-Return to make extended selections. Turn off the
  39.   menu bar by pressing ESCape or Amiga-Help again. You may at any time
  40.   grab the mouse and take over control.
  41.  
  42. First Letter Matching:
  43.  
  44.   If you wish, you may activate a menu by pressing a qualifier key and
  45.   the first letter of a menu. To use this feature you must start PCMenu
  46.   with the +q option. +qA would mean that when you press Alternate-B, for
  47.   example, the first menu that begins with the letter B will become active.
  48.   If no menu begins with the selected letter, it will be passed through.
  49.   Deactivate the menu bar by pressing ESCape.
  50.  
  51. Item Selecting:
  52.  
  53.   After activating the menu bar, you may use the arrow keys or, you may
  54.   highlight menu items or subitems by pressing the first letter in the item
  55.   or subitem's name. Select the item by pressing Return. Press Shift-Return
  56.   to make extended selections. You may combine "highlighting" and "selecting
  57.   with letter matching" by using the -L option.
  58.  
  59. Selection Notes:
  60.  
  61.   1. Pressing a letter key will highlight the first menu item that
  62.      matches. If there are more matching menu items, repeated pressing
  63.      will highlight each. See the -L option below for immediate selecting.
  64.  
  65.   2. Menu items will be checked for matches unless the highlighted menu
  66.      item has subitems in which case only the subitems will be checked.
  67.  
  68.   3. Preceding blanks in menu items will be skipped. This means that you
  69.      cannot select items by pressing the space bar.
  70.  
  71.   4. If a subitem has more than one subitem displayed horizontally, you
  72.      may need to select subitems that are to the right by pressing the
  73.      down arrow. Pressing the right arrow while a subitem is highlighted
  74.      will activate the next menu.
  75.  
  76.   5. PCMenu will remember which item and subitem was highlighted last
  77.      and will automatically go to that selection the next time.
  78.  
  79.  
  80. ========================================================================
  81.  
  82. CHANGING THE MENU ACTIVATING KEY AND QUALIFIER KEYS
  83.  
  84. From the CLI:
  85.  
  86.   You may change the menu activation key with the -kxx option. Replace xx
  87.   with the hex code for the desired key. For Example:
  88.  
  89.     PCMenu -k59
  90.  
  91.   will use Amiga-F10. Some of the key codes are listed below.
  92.  
  93.   You may change the qualifiers that will be used with this key.
  94.   For example:
  95.  
  96.     PCMenu -qSR
  97.  
  98.   will use Shift-Right_Amiga-Help to activate the menus. The qualifiers
  99.   are listed below.
  100.  
  101.  
  102. From Workbench:
  103.  
  104.   To change the key used to activate the menus, enter in the ToolTypes
  105.   gadget:
  106.  
  107.     MENU KEY=xx
  108.  
  109.   Replace xx with the hex key code.
  110.  
  111.   To change the qualifier used with the menu key to (for example)
  112.   Shift-Alternate, enter in the ToolTypes gadget:
  113.  
  114.     MENU QUALIFIER=SHIFT+ALTERNATE
  115.  
  116.   These are case sensitive! They must be all upper case.
  117.  
  118.   The qualifiers are listed below.
  119.  
  120.  
  121. ========================================================================
  122.  
  123. CHANGING "FIRST LETTER MATCHING" QUALIFIER
  124.  
  125. From the CLI:
  126.  
  127.   You may set the qualifiers to be used with the "first letter
  128.   matching" feature. Use the "+q" with the desired qualifiers.
  129.   For example:
  130.  
  131.     PCMenu +qCE
  132.  
  133.   will let you select a menu by pressing Control-Amiga and the first
  134.   letter of the desired menu. Note that either Amiga key may be used in
  135.   this case.
  136.  
  137.  
  138. From Workbench:
  139.  
  140.   To enable menu letter matching with (for example) the Alternate key,
  141.   enter in the ToolTypes gadget:
  142.  
  143.   LETTER MATCHING QUALIFIER=ALTERNATE
  144.  
  145.   These are case sensitive! They must be all upper case.
  146.  
  147.  
  148. ========================================================================
  149.  
  150. QUIET AND DISABLED ITEM OPTIONS
  151.  
  152.   You may prevent the opening information window from being displayed
  153.   and allow the mouse to move to disabled items.
  154.  
  155. From the CLI:
  156.  
  157.   Prevent the opening window with the "quiet" option.
  158.   Allow the mouse to move to disabled items with the -d option.
  159.   For example:
  160.  
  161.     PCMenu -d quiet
  162.  
  163.  
  164. From the Workbench:
  165.  
  166.   Enter in the ToolTypes gadget of the icon:
  167.  
  168.   DISABLED ITEM=TRUE    Allows mouse to move to disabled items.
  169.   DISABLED ITEM=FALSE   Does not allow it.
  170.  
  171.   QUIET=TRUE          No opening window.
  172.   QUIET=FALSE         Allows opening window.
  173.  
  174.   Note that the quiet option is available only to registered users.
  175.  
  176.  
  177. ========================================================================
  178.  
  179. COMBINING SELECTING AND HIGHLIGHTING WITH LETTER MATCHING
  180.  
  181.   Most PC programs allow you to highlight and select item by pressing a
  182.   letter. PCMenu normally allows only the highlighting of item when a key
  183.   is pressed. You then need to press <Return> to select it. You may
  184.   automatically select it without pressing <Return> by using the -L option.
  185.  
  186. ========================================================================
  187.  
  188. THE QUALIFIERS USED
  189.  
  190. From the CLI:
  191.  
  192.   A - Alternate   S - Shift
  193.   C - Control     L - Left Amiga
  194.   R - Right Amiga E - Either Amiga
  195.   N - Numeric keypad
  196.  
  197.  
  198. From Workbench:
  199.  
  200.   These are the allowable qualifier keywords entered in ToolTypes:
  201.  
  202.   SHIFT              Either shift key
  203.   CONTROL
  204.   ALTERNATE          Either alternate key
  205.   LEFT AMIGA         AKA the C= key
  206.   RIGHT AMIGA
  207.   EITHER AMIGA
  208.   NUMERIC
  209.  
  210.   The Left Amiga key on some 500s and 2000s is the C= key.
  211.  
  212.   If you use a numeric keypad key, you must use the -qN or NUMERIC option.
  213.  
  214.  
  215. ========================================================================
  216.  
  217. Examples:
  218.  
  219.   PCMenu
  220.     Uses defaults
  221.  
  222.   PCMenu -qSR
  223.     Uses Shift-Right_Amiga with the Help key.
  224.  
  225.   PCMenu -qCE +qSR
  226.     Uses Control-Left_Amiga or Control-Right_Amiga with the Help key
  227.     and Shift-Right_Amiga with a letter key to select a menu by its
  228.     first letter.
  229.  
  230.   PCMenu -qN -k4a quiet
  231.     Uses the numeric pad "-" instead of the Help key. The signon window
  232.     is not displayed.
  233.  
  234.   PCMenu +qE -L
  235.     Use either Amiga key for menu letter matching and immediately select
  236.     an item when you press a letter that matches an item.
  237.  
  238. ========================================================================
  239.  
  240. Some of the hex key codes are:
  241.  
  242.   Numeric Pad 0           0f
  243.   Numeric Pad 1           1d
  244.   Numeric Pad 2           1e
  245.   Numeric Pad 3           1f
  246.   Numeric Pad 4           2d
  247.   Numeric Pad 5           2e
  248.   Numeric Pad 6           2f
  249.   Numeric Pad 7           3d
  250.   Numeric Pad 8           3e
  251.   Numeric Pad 9           3f
  252.   Numeric Pad .           3c
  253.   Numeric Pad -           4a
  254.   Numeric Pad Enter       43
  255.   Numeric Pad (           5a
  256.   Numeric Pad )           5b
  257.   Numeric Pad /           5c
  258.   Numeric Pad *           5d
  259.   Numeric Pad +           5e
  260.   Backslash               0d
  261.   Backspace               41
  262.   Tab                     42
  263.   Return                  44
  264.   Esc                     45
  265.   Delete                  46
  266.   Up arrow                4c
  267.   Down arrow              4d
  268.   Right arrow             4e
  269.   Left arrow              4f
  270.   Help                    5f
  271.   Function Key 1          50
  272.   Function Key 2          51
  273.   Function Key 3          52
  274.   Function Key 4          53
  275.   Function Key 5          54
  276.   Function Key 6          55
  277.   Function Key 7          56
  278.   Function Key 8          57
  279.   Function Key 9          58
  280.   Function Key 10         59
  281.  
  282.  
  283. ========================================================================
  284.  
  285. Notes: This program may not function properly when MachIII is running
  286.        with the option MTM (Mouse To Menu) on. (Use MachIV!)
  287.  
  288.        If you use the option +qR or +qE, keyboard equivalents and keyboard
  289.        menu shortcuts such as Amiga-C will not work if a menu begins
  290.        with that letter. That means that you won't be able to use
  291.        Right-Amiga-X to clear a string gadget if a menu begins with X. If
  292.        this is a problem, a better choice might be +qA or +qSR or +qL.
  293.  
  294.  
  295. ========================================================================
  296.  
  297. PCMenu is shareware. If you use this program you should send $10 to:
  298.  
  299. Polyglot Software
  300. 884 W. Melrose Ln
  301. Boise, ID  83706
  302.  
  303. If a newer version is available, it will be sent to you. Registered versions
  304. have the "quiet" option enabled.
  305.  
  306.  
  307. PCMenu - Copyright 1991-1992 by Brian Moats.
  308.  
  309.  
  310.  
  311. Also available:
  312.  
  313.    PCMenuSpeak - This is the same program as PCMenu but all menu items
  314.                  are spoken as they are highlighted. Volume names may also
  315.                  be spoken as they are inserted. Highly useful for visually
  316.                  impaired users.
  317.                  $10.00.
  318.  
  319.  
  320.  
  321. Any questions or problems should be directed to:
  322.  
  323. Brian Moats
  324. Polyglot Software
  325. 884 W. Melrose Ln.
  326. Boise, ID  83706
  327.  
  328. (208) 336-4583
  329.