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