home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 402.lha / PopUpMenu_v3.4 / PopUpMenu.doc < prev    next >
Text File  |  1990-07-27  |  6KB  |  175 lines
  1.     PopUpMenu V3.4 by Martin Adrian           90-05-25
  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.     What is it ?
  13.     ~~~~~~~~~~~~
  14.     This small program makes it possible for You to use popupmenues with
  15.      every program that uses standard intuition menues.
  16.      ~~~~~
  17.     The popupmenues works just like the standard pull-down menues for both
  18.      the user (multiple selections, checkmarks, commandkeys) and the
  19.      programmer (MENUPICK and MENUVERIFY).
  20.      All intuition menu-flags (COMMSEQ, HIGHBOX, MENUTOGGLE ...)
  21.      are fully supported.
  22.  
  23.     Features:
  24.     ~~~~~~~~~
  25.     * The Pop-up menues will not show up when you press the menubutton
  26.        if any of the following conditions are true:
  27.  
  28.        1) No window is active.                  \
  29.        2) The active window has no menues.          |
  30.        3) The active window has the flag RMBTRAP set. |-  Same as Intuition
  31.        4) The active window has a requester open.     /
  32.  
  33.        5) The mousepointer is in the screens menubar.
  34.       (standard pull-down menues will appear)
  35.        6) You are pressing any qualifier key.
  36.       (shift, alt, ctrl, left or right Amiga, left (or middle) mousebutton)
  37.  
  38.     * If a menuitem has subitems this is marked with a small arrow.
  39.  
  40.     * The program remembers the last menu selected.
  41.        (Works only with items selected with PopUpMenues and does not remember
  42.     different windows).
  43.  
  44.    Differences from Intuition:
  45.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  46.    Bad:
  47.      Drag-select is not supported (i never use it), Use Multiple selcet.
  48.      If a Menu is disabled the menuitems will not show up.
  49.      PopUpMenu does not sort the menues after their LeftValue (they may
  50.       show up in the wrong order).
  51.  
  52.    Good:
  53.      Mousepointer don't stop while menuwindows are opened or closed.
  54.  
  55.    Good or bad ?
  56.      PopUpMenu does not remove any inputevents (RAWKEY, MOUSEMOVE ...)
  57.      while the menues are shown.
  58.  
  59.  
  60.    Installation:
  61.    ~~~~~~~~~~~~
  62.    To use the program put the file `PopUpMenu' and 'PopUpMenu.info'
  63.      in your current directory.
  64.  
  65.    To turn on the pop-up menues just type:
  66.  
  67.      1> PopUpMenu
  68.  
  69.    (If You (or maybe Kickstart 2.0) don't like selfdetaching programs,
  70.      Run (or RunBack) the PopUpMenu.run program, (Stacksize >= 2000)
  71.  
  72.    To turn them off, just type:
  73.  
  74.      1> PopUpMenu
  75.  
  76.    Workbench users can click the PopUpMenu-icon.
  77.  
  78.    The program will take up 9K !  (including stack)
  79.  
  80.    Distribution
  81.    ~~~~~~~~~~~~
  82.  
  83.    This version of the PopUpMenu program is released as Public Domain.
  84.                             ~~~~~~~~~~~~~~
  85.      This program can be used, copied, included in a library or commercial
  86.      product as long as You don't do it for profit.
  87.      (Please include PopUpMenu.doc in the copy)
  88.  
  89.      You may also use the source for your own programs, but if You intend
  90.      to do a similar popupmenu-program with it please let me know.
  91.  
  92.    Warnings:
  93.    ~~~~~~~~~
  94.    * A bug in intuition will sometimes lock the inputhandler (Mousepointer
  95.        and keyboard will freeze).  This happens when intuition tries to change
  96.        the screen (i.e draw something) while menues are displayed.
  97.      The PopUpMenu program will detect this, fix it, and then resume the
  98.        menuoperation. (The menues flashes once).
  99.  
  100.    * It is not possible to remove older versions (2.42 and lower) with
  101.        this program.
  102.  
  103.    * The program RSdemo scrolls it's screen if you press an arrowkey while
  104.        menues are shown. RSdemo doesn't seem to use layers.library for the
  105.        drawing (The screen is locked).) This do not happen with the intuition
  106.        menues because intuition eats all inputevents during menu operation.
  107.  
  108.  
  109.    FUTURE:
  110.    ~~~~~~~
  111.     Size is to big.
  112.  
  113.     The program only remembers the last menu (not menuitem or subitem) selected.
  114.  
  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  (not sure if this works anymore)
  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.
  133.  
  134.  
  135.    New in version 3.4
  136.    ~~~~~~~~~~~~~~~~~~
  137.    For safety:
  138.    * Now checks to see if screen and window is still present after the
  139.       intuition bug fixup.
  140.    * Rearranged the files so all PopUpMenu hunks shows in Xoper.
  141.       (It should be 3 of them)
  142.  
  143.    For compability:
  144.    * Fixed a small bugs that sometimes made itemwindows to small.
  145.  
  146.    * The program no longer clears the menuitemfield before drawing
  147.       the highimage. (Intuition doesn't)
  148.  
  149.    For Distribution:
  150.    * Now the PopUpMenu.run works (Ver 3.2 didn't  OOPS!).
  151.  
  152.    * Size is now < 7K.
  153.  
  154.    New in version 3.2
  155.    ~~~~~~~~~~~~~~~~~~
  156.    For speed:
  157.    * Some code optimizations (C -> Assembler).
  158.  
  159.    For safety:
  160.    * MENUVERIFY is now fully supported.
  161.    * Forbid() and LockIBase() is now used where needed. (I hope.)
  162.    * Made my own SwapBitsRastPortClipRect.   (No more guru #81000005)
  163.  
  164.    For use:
  165.    * Shows if an item has subitems.
  166.    * Now always shows items & subitems (even if they cover other menuwindows).
  167.    * Now resumes after the intuition lock-up.
  168.  
  169.    For compability:
  170.    * Fixed Fontbug.
  171.  
  172.    New Distrbution:
  173.    * Public Domain.  (i'm not a poor student anymore 8-) )
  174.  
  175.