home *** CD-ROM | disk | FTP | other *** search
/ Enigma Amiga Life 106 / EnigmaAmiga106CD.iso / software / readme / mcc_popph.readme < prev    next >
Encoding:
Text File  |  1999-09-01  |  5.3 KB  |  137 lines
  1. Short:    Complex popup placeholder class (MUI)
  2. Author:   Marcin Orlowski <carlos@amiga.com.pl>
  3. Uploader: Marcin Orlowski <carlos@amiga.com.pl>
  4. Version:  14.7
  5. Type:     dev/mui
  6. Www:      http://amiga.com.pl/mcc/
  7. Replaces: dev/mui/MCC_Popph.*
  8. Date:     Tue Aug 31 10:28:52 1999
  9.  
  10.  
  11.   Short
  12.   -----------------------------------
  13.  
  14.   Popplaceholder class is a simple but useful class ;) Most applications
  15.   are fully configurable nowadays, offering wide range of various
  16.   parameters for further user modifications.  Not only functions options
  17.   or forms of behaviour are configurable but often most of program
  18.   strings can now be changed by the user.  The latter applies to
  19.   internet (communication) related programs mostly, (e.g.  AmIRC,
  20.   AmTelnet, YAM and so on...) which needs to send various string to
  21.   other different people.  So they allow you to define e.g.  own welcome
  22.   phrase or kick reason sentence.  Because e.g.  your welcome phrase for
  23.   e.g.  John and phrase for Mary will differ only with the name, most of
  24.   these strings uses so called placeholders, to describe varable,
  25.   dynamically modified string part (e.g.  mentioned receipient name).
  26.   For example "On %d, %u wrote:".  The "%d" and "%u" ares just the
  27.   placeholders, program will replace on use by for instance mail date
  28.   and the sender's name (of course placeholder can look like "@name" or
  29.   "%{date}" or "my lovely grandma", but the idea behind remains).
  30.  
  31.   Unfortunately, most programs forces user to know what placeholder can
  32.   be user where and which means what.  That's kinda user unfriendly
  33.   (especially for beginners, or just-users).  Instead of forcing them to
  34.   type placeholders by hand (in proper syntax!) it would be nicer to let
  35.   them pick up what they want from the list of available items.  That
  36.   both eliminates placeholder syntax problems (unless user 'fix' it
  37.   later by hand of course) as well as disallows to use unsupported
  38.   placeholder (the above exception applies of course).  And here comes
  39.   Popplaceholder class.  It features the ordinary string gadget user can
  40.   type own text in, but it also gives the popup listview, which holds
  41.   all available placeholders.  User can easily select one from the list
  42.   either by double click or by neat Drag&Drop.  See the example demo
  43.   program for better picture of the class' features.
  44.  
  45.  
  46.   Popplaceholder is freeware software, but it's copyrighted
  47.   © 1999 by Marcin Orlowski <carlos@amiga.com.pl>
  48.  
  49.   PS: Yes, I know my english sucks ;)
  50.  
  51.  
  52.   Software using that class:
  53.   -----------------------------------
  54.  
  55.   - AmIRC
  56.   - AmTelnet
  57.   - OpenURL 3
  58.  
  59.   -> let me know about your!
  60.  
  61.  
  62.   History
  63.   -----------------------------------
  64.  
  65.   14.0 (Mon Jul 12 10:15:34 1999)
  66.        - initial version
  67.  
  68.   14.1 (Mon Jul 12 13:09:21 1999)
  69.        - Added MUIA_Poplaceholder_Copy attribute
  70.        - now forwards all list object methods
  71.          to internal pop up list, increasing
  72.          flexibility
  73.  
  74.   14.2 (Tue Jul 13 19:35:58 1999)
  75.        - shortened all these "MUIx_Popplaceholder_#?"
  76.          to "MUIx_Popph_#?" for easier programming ;)
  77.        - added Drag&Drop feature
  78.  
  79.   14.3 (Wed Jul 14 14:05:34 1999)
  80.        - first public release
  81.        - wrote autodocs
  82.        - added support for existing string gadget
  83.          replacements (the fallback scheme looks like:
  84.          Textinput -> Betterstring -> original String)
  85.        - MUIA_Popph_StringMaxLen is gettable now
  86.  
  87.   14.4 (oops, I forgot the datestamp)
  88.        - added support for popup menu when Textinput
  89.          subclass is used
  90.        - added MUIA_Popph_ReplaceMode attribute
  91.  
  92.   14.5 (Sun Jul 25 19:58:25 1999)
  93.        - Popplaceholder is now 2-in-1 custom class
  94.          (poplaceholderstr.mcc is now useless and
  95.          should be wiped out of your disks)
  96.        - added some internal checks to avoid possible
  97.          problems with tag/descriptions being longer
  98.          than predefined max length
  99.        - Popph object is no longer higher than highest
  100.          object it uses
  101.        - MUIA_Popph_StringType added
  102.        - all TI/BS/String attrubutes are now forwarded
  103.          to internal string object on OM_SET/OM_GET.
  104.          Just talk to Popph as to string gadget
  105.        - added PopAsl alike work mode
  106.  
  107.   14.6 (Tue Jul 27 16:09:44 1999)
  108.        - MUIA_Version, MUIA_Revision are now supported
  109.        - fixed bad enforcer hit "implemented" in 14.5
  110.        - MUIA_Popph_Avoid added
  111.        - added MUIA_Popph_StringObject, MUIA_Popph_ListObject
  112.  
  113.   14.7 (Tue Aug 31 10:28:35 1999)
  114.        - all list methods and attributes are now forwarded
  115.          to internal list object. Handle with care.
  116.        - public release
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.           ___  ___  ___    ________    ___  ___  ___    ___  ___
  124.          /   \/   \/   \  /        \  /   \/   \/   \  /   \/   \
  125.         /    /    /    / /         / /    /    /    / /    /    /
  126.        /    /    /    / /    _____/ /    /    /    / /    /    /
  127.       /    /    /    / /        \  /    /    /    / /         /
  128.      /    /    /    / /         / /    /    /    / /         /
  129.     /    /    /    / /    _____/ /    /    /    / /    /    /
  130.    /    /    /    / /    /      /    /    /    / /    /    /
  131.    \___/\___/\___/ /    /       \___/\___/\___/  \___/\___/
  132.                   /    /
  133.                   \___/                    W.F.M.H. on-line
  134.                                          http://wfmh.org.pl
  135.  
  136.                Amiga software: http://amiga.com.pl/
  137.