home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / commod / altmenu.lha / AltMenuCom.doc < prev    next >
Text File  |  1992-05-23  |  11KB  |  221 lines
  1. ==============================================================================
  2.  
  3.         AltMenu                         V1.0
  4.         © J.Tyberghein                  Sat May 23 16:48:40 1992
  5.  
  6. ==============================================================================
  7.  
  8.  
  9.  
  10. Preface
  11. -------
  12.   There aren't many things I like about MS-Windows(TM). There is however
  13.   one big exception: I very much like the ability to do everything with
  14.   the keyboard instead of the mouse. The Amiga operating system only
  15.   provides shortcuts for some of the menus (program dependant) and some
  16.   of the gadgets (also program dependant). This commodity tries to solve
  17.   at least one of these shortcomings. When ALTMENU is running you can use
  18.   the left-alt key (or another key if you like) to go to menu mode (just
  19.   like in Windows). When you are in menu mode, you can use the arrow keys
  20.   to move in the menu's. Pressing enter will activate the highlighted
  21.   menuitem. ALTMENU does not force you to use this method. You can still
  22.   use the menus in the old way. ALTMENU uses less than 9K of your precious
  23.   memory (if you are already running another commodity).
  24.  
  25.   This program (ALTMENU V1.0) is public domain.
  26.   If you want to use this program for commercial purposes please write
  27.   for permission !
  28.  
  29.   If you have any suggestions or remarks you can write to (Bug reports are
  30.   welcome too)
  31.  
  32.                             Jorrit  Tyberghein
  33.                              Hepmansbossen 31
  34.                            2450 Meerhout BELGIUM
  35.  
  36.  
  37. NOTE
  38. ----
  39.  
  40.   If you want to use this utility you must have AmigaDOS 2.0 (or later :-)
  41.   To recompile ALTMENU you need SAS/C 5.10 (or higher).
  42.   ALTMENU uses no dirty tricks and no patches to the system to implement
  43.     the menu walking. ALTMENU works by installing an input.device handler
  44.     (with commodities) and substituting several input events by other
  45.     mouse moving input events.
  46.  
  47.  
  48. Cli Usage
  49. ---------
  50.  
  51.   +----------------------------------------------------------------------+
  52.   | Commandline template:                                                |
  53.   |   LALT/s,RALT/s,CTRL/s,LCMD/s,RCMD/s:                                |
  54.   +----------------------------------------------------------------------+
  55.  
  56.   The default key for ALTMENU is the left-alt (LALT) key.
  57.   Choose LALT, RALT, CTRL, LCMD or RCMD for left-alt, right-alt, control,
  58.   left-amiga or right-amiga respectively.
  59.   To minimize memory usage I recommend that you start ALTMENU from the
  60.   Workbench (in the WBStartup directory for example). Otherwise you will
  61.   loose some memory for the larger CLI stack.
  62.  
  63.  
  64. Workbench Usage
  65. ---------------
  66.  
  67.   Use LALT, RALT, CTRL, LCMD or RCMD to choose the right key.
  68.   Use the DONOTWAIT tooltype if you want to start ALTMENU from
  69.   your WBStartup directory.
  70.  
  71.  
  72. Terminology
  73. -----------
  74.  
  75.   First some terminology:
  76.     - LMB is the left mouse button.
  77.     - RMB is the right mouse button.
  78.     - Sh-<key> is equivalent to pressing shift together with <key>
  79.     - A menu represents the first level in the menu tree. For each
  80.       name in the menu titlebar you have a menu (for example: the
  81.       'Project' menu, the 'Edit' menu, ...)
  82.     - A menuitem represents the second level. Each menu has one or more
  83.       menuitems (for example: 'Load', 'Save', ...)
  84.     - A subitem represents the last level. Some menuitems can have
  85.       one or more subitems.
  86.     - An item is one of the following: a menu, a menuitem or a subitem.
  87.     - A selected item is the item on the highest level in the menu tree
  88.       that is highlighted (or selected).
  89.     - The selected level is the number of the highest selected item
  90.       in the menu tree (1 for menus, 2 for menuitems or 3 for subitems).
  91.  
  92.   An example (the Workbench screen):
  93.  
  94.       -----------------------------------------------
  95.       Workbench    WINDOW   Icons    Tools
  96.       ------------+---------------+------------------
  97.                   |New Drawer     |
  98.                   |Open Parent    |
  99.                   |Close          |
  100.                   |Update         |
  101.                   |Select Cont+-------+
  102.                   |Clean Up   |WINDOW |
  103.                   |SNAPSHOT   |All    |
  104.                   |Show       +-------+
  105.                   |View By       »|
  106.                   +---------------+
  107.  
  108.       All capitalized names are highlighted. In this example, the selected
  109.       menu is WINDOW, the selected menuitem is SNAPSHOT and the selected
  110.       subitem is also WINDOW. The selected item is the subitem WINDOW because
  111.       it is the item that is selected with the highest level (level 3).
  112.       The selected level is equal to 3.
  113.  
  114.  
  115. How does it work?
  116. -----------------
  117.  
  118.   The following explanation is rather technical. But it's the only way
  119.   I could think of to explain the exact behaviour of ALTMENU. I hope you
  120.   can understand this information. If not, don't panic. I think the program
  121.   is easy to use. You can experiment on your own with the arrow keys, the
  122.   space bar and the enter key (the only keys you really need to navigate
  123.   in the menus).
  124.  
  125.   When ALTMENU is running your Amiga can be in one of the two following
  126.   modes: menu mode or normal mode. You can go to menu mode with the
  127.   left-alt key (in this section I assume that you use the default key.
  128.   If this is not the case you should 'think' some other key when you read
  129.   'left-alt'). Note that ALTMENU will only go to menu mode when you release
  130.   the alt key without doing something else in the meantime. This means that
  131.   you can still use the alt key in combination with some other key (or
  132.   in combination with a mouse button). In summary, to go to menu mode, you
  133.   must press and release the alt key with no other actions.
  134.  
  135.   When you press the left-alt key, you will see that the mouse pointer moves
  136.   to the upper left corner of the active screen (this only happens if there
  137.   are menus attached to the active window) and the first menu will open.
  138.   You are now in selected level 1 (menu level) and the first menu is
  139.   selected (the selected item is equal to the first menu).
  140.  
  141.   When you are in menu mode you can use the following keys:
  142.     left-alt : Leave menu mode and cancel the menu operation. Note that all
  143.                menu actions indicated with the space bar will not be
  144.                canceled. After you have canceled menu mode, the mouse pointer
  145.                will return to the original position before menu mode was
  146.                entered.
  147.     RMB      : Leave menu mode and cancel the menu operation (like the
  148.                left-alt key). There is one exception: if the selected
  149.                menu or menuitem has submenus the mouse pointer will move
  150.                to that menu or menuitem. After that you will still be in menu
  151.                mode.
  152.     Left     : Go to the menu left of the current selected menu. If the
  153.                current selected menu is the leftmost menu, ALTMENU will
  154.                go to the rightmost menu (wrap). After this operation the
  155.                current selected level will be 1 (menu level). There is
  156.                one exception to this behaviour: if you are in level 3
  157.                (subitem level) pressing the left arrow key will cause ALTMENU
  158.                to go to level 2 (menuitem level).
  159.     Right    : Go to the menu right of the current selected menu. If the
  160.                current selected menu is the rightmost menu, ALTMENU will
  161.                go to the leftmost menu (wrap). After this operation the
  162.                current selected level will be 1 (menu level). There is
  163.                one exception to this behaviour: if you are in level 2
  164.                (menuitem level) and the selected menuitem has subitems,
  165.                pressing the right arrow key will cause ALTMENU to go to
  166.                level 3 (go in the subitem level).
  167.     Up       : Go to the previous menuitem or subitem. If you are in
  168.                selected level 2 and the current selected menuitem is
  169.                the highest possible menuitem, pressing the up arrow key
  170.                will cause ALTMENU to go to level 1 (menu level).
  171.     Down     : Go to the next menuitem or subitem (if there is one).
  172.                If you are in level 1 (menu level) pressing the down arrow key
  173.                will cause ALTMENU to go to level 2 (menuitem level).
  174.     Sh-left  : Go to the leftmost menu (level 1).
  175.     Sh-right : Go to the rightmost menu (level 1).
  176.     Sh-up    : Go to the hightest menuitem or subitem.
  177.     Sh-down  : Go to the lowest menuitem or subitem.
  178.     Enter    : Activate the selected item and go back to normal mode
  179.                (leave menu mode).
  180.     Space    : Activate the selected item but remain in menu mode (this is
  181.                useful to multiple select some items). With this key you can
  182.                select more items at the same time (if the program is
  183.                properly written and supports this feature (it should!)).
  184.     A letter : When you press a letter, ALTMENU will search in the current
  185.                selected level to the next item with a name starting with
  186.                the letter. If this item is found, it will be selected. If
  187.                the item has menuitems or subitems the selected level will
  188.                increase by one (ALTMENU will go in this menuitem or subitem).
  189.  
  190.     Pressing the left-alt key when you are in normal mode is not the only
  191.     way to go to menu mode. If you 'walk' the menus in the old way (with
  192.     the RMB) you can select an item by releasing the RMB. However, if the
  193.     selected item has subitems (if the item is a menu or a menuitem with
  194.     subitems) ALTMENU will enter menu mode and choose the selected item
  195.     as the current item. Using this technique you can start walking the
  196.     menus with the arrow keys at a later time.
  197.  
  198.     When you are walking the menus with the arrow keys (in menu mode) you
  199.     must be careful when you move the mouse pointer manually. ALTMENU will
  200.     not know that you haved moved the mouse and will assume that the mouse
  201.     pointer is still located above what ALTMENU thinks is the selected
  202.     item. In general there is no problem if you don't use the arrow keys
  203.     after you have moved the mouse pointer manually. If you want to use
  204.     the arrow keys again there are two possibilities: either you position
  205.     the mouse pointer back on the original selected item or you choose
  206.     another starting position by releasing the RMB on a menu or menuitem with
  207.     subitems. In an earlier version of ALTMENU I tried to solve this
  208.     problem by scanning the menu tree to see which items were selected. But
  209.     I discovered that the menu tree is in an inconsistant state when
  210.     multiple select is used (space bar): more than one item was selected
  211.     according to the flags in the menu structures!
  212.  
  213.     To quit ALTMENU you must use the 'Exchange' program.
  214.  
  215.  
  216. ==============================================================================
  217.  
  218.                          End of ALTMENU 1.0 document
  219.  
  220. ==============================================================================
  221.