home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 1662.dms / in.adf / Docs / PopUpMenu.doc < prev    next >
Encoding:
Text File  |  1993-03-05  |  4.2 KB  |  134 lines
  1.     PopUpMenu V2.42 (ShareWare) by Martin Adrian            89-12-06
  2.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4.     Introduction
  5.     ~~~~~~~~~~~~
  6.    Are you using QMose, DMouse, or HeliosMouse and "always" get the wrong
  7.     menues when you press the mousebutton?
  8.    Have you ever needed pop-up menues for your Amiga?
  9.  
  10.    The solution: PopUpMenu
  11.  
  12.     Differences from version 1.38
  13.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  14.     For speed:
  15.     * Now uses SwapBitsRastPortClipRect().
  16.     * No delay before opening windows. (sorry if You liked it)
  17.  
  18.     For safety:
  19.     * MENUVERIFY is supported.
  20.     * Uses Semaphores to prevent anyone from changing the displayed manues.
  21.     * Now checks to see that no requester is open.
  22.  
  23.     For use:
  24.     * Remebers last selected menu.
  25.     * Installs automaticly (no need for Run).
  26.     * Workbench support. (with icon)
  27.  
  28.     For compability:
  29.     * Multiple select is supported. (not drag-select)
  30.     * Shows Commandkeys.
  31.     * Now opens item & subitemwindows like intuition (not next to mousepointer).
  32.     * Fixed Colourbug.
  33.  
  34.     New Distrbution:
  35.     * ShareWare.
  36.  
  37.     Distribution
  38.     ~~~~~~~~~~~~
  39.  
  40.    This version of the PopUpMenu program is released as ShareWare.
  41.                             ~~~~~~~~~~
  42.      You may freely copy this program or include it in a library BUT if You
  43.      intend to use it please send me $10.
  44.      Sending me a 3.5" disk (Or $2) together with the fee means that you
  45.      will recieve the latest version together with the source (in Lattice C).
  46.  
  47.      The Fee can be paid in any currency my bank accepts.
  48.  
  49.     Installation:
  50.     ~~~~~~~~~~~~
  51.  
  52.    To use the program put the file `PopUpMenu' and 'PopUpMenu.info'
  53.     in your current directory.
  54.  
  55.  
  56.    To turn on the pop-up menues just type:
  57.  
  58.      1> PopUpMenu
  59.  
  60.    To turn them off, just type:
  61.  
  62.       1> PopUpMenu
  63.  
  64.    Workbench users can click the PopUpMenu-icon.
  65.  
  66.    The program will take up 9K. (including stack)
  67.  
  68.    Features:
  69.    ~~~~~~~~~
  70.    The Pop-up menues will not show up when you press the menubutton
  71.     if any of the following conditions are true:
  72.  
  73.    1) No window is active.
  74.    2) The active window has no menues.
  75.    3) The active window has the flag RMBTRAP set.
  76.    4) The active window has a requester open.
  77.    5) The mousepointer is in the screens menubar.
  78.     (standard pull-down menues will appear)
  79.    6) You are pressing any qualifier key.
  80.     (shift, alt, control, left or right Amiga, left (or middle) mousebutton)
  81.  
  82.  
  83.    Differences from Intuition:
  84.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  85.    Bad:
  86.      Drag-select is not supported (i never use it), Use Multiple selcet.
  87.      If a Menu is disabled the menuitems will not show up.
  88.    Good:
  89.      Mousepointer don't stop while menuwindows are opened or closed.
  90.      The program remembers the last menu selected.
  91.        (Works only with items selected with PopUpMenues and does not remember
  92.     different windows).
  93.  
  94.    Warnings:
  95.    ~~~~~~~~~
  96.     * The program tries to open the item and subitem windows in this oreder:
  97.      1) Like intuition.
  98.      2) On the right side of the menuwindow.
  99.      3) On the left   - " " -  - " " -.
  100.      if 1,2 & 3 fails (or out of memeory) the window will not be opened.
  101.  
  102.     * A bug in intuition will sometimes lock the inputhandler. (Mousepointer
  103.     and keyboard will freeze)  Happens then someone tries to change
  104.     the screen (i.e open a window) while menues are displayed.
  105.       The PopUpMenu program will detect this and then quit the menuoperation.
  106.  
  107.    FUTURE:
  108.    ~~~~~~~
  109.     Maybe i'll find another solution for the intuition bug.
  110.       (like resuming instead of aborting)
  111.     MENUVERIFY is currently sent only to the active window.
  112.       (should be all windows on same screen with MENUVERIFY set)
  113.     Size is to big.
  114.     The program only remembers the last menu (not menuitem or subitem) selected.
  115.  
  116.    Author:
  117.    ~~~~~~~
  118.      Martin Adrian                              o
  119.      Motgången 305            (the å is an 'a' with a ring above -> a)
  120.      S-412 80  Gothenburg
  121.      Sweden
  122.  
  123. USENET d5adria@dtek.chalmers.se
  124.  
  125.    Thanks to:
  126.     Derek Zahn          for the PopUpMenu program on FishDisk 96
  127.     Commodore          for the Amiga
  128.     Arp - people          for Arp 1.3 & AShell
  129.     Lattice           for the C compiler (5.0)
  130.     My English teatcher
  131.     Anna              my girlfriend
  132.     You              for using this program (don't forget the $10 fee)
  133.  
  134.