home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 19 / AACD19.BIN / AACD / Programming / MCC_NListtree / MCC_NListtree.readme < prev    next >
Encoding:
Text File  |  2001-02-24  |  9.2 KB  |  225 lines
  1. Short:      MUI list tree class for NList
  2. Uploader:   cs@aphaso.de (Carsten Scholling)
  3. Author:     cs@aphaso.de (Carsten Scholling)
  4. Type:       dev/mui
  5. Requires:   OS2.x, MUI3.8, NList19.98
  6. Version:    18.7
  7. Replaces:    MCC_NListtree.lha
  8.  
  9.  
  10. Description:
  11. ¯¯¯¯¯¯¯¯¯¯¯
  12.   This  MUI  custom  class provides you with an easy way of displaying list
  13. entries  in  a  sorted  form, a so called tree-structure.  A Tree-structure
  14. will be selected, when data should be optical seperated from each other.
  15.  
  16.   NListtree is intresting for programmers and the end-user also and easy to
  17. use.   So  far  as  implemented  by  the  programmer  and  needfull  in the
  18. application environment, this class allows the fully free recreation of the
  19. list using drag&drop (short d&d) with support of multiselection.
  20.  
  21.   First  time  in  a  list  tree  class  it  is  possible  to move complete
  22. structures.  That means, that the complete tree of the moved entry, back to
  23. the  root-list,  is  recreated  at the destination if the programmer allows
  24. this.  The same for copying entries, which is also implemented.
  25.  
  26.  
  27.  
  28. Requirements:
  29. ¯¯¯¯¯¯¯¯¯¯¯¯
  30.  - OS2.x
  31.  - MUI3.8
  32.  - MCC_NList 0.90 (NList.mcc 19.98)
  33.  
  34.  
  35. Installation:
  36. ¯¯¯¯¯¯¯¯¯¯¯¯
  37.  - Simply use the supplied installer script.
  38.  
  39.  
  40.  
  41. History:
  42. ¯¯¯¯¯¯¯
  43.  
  44.   V18.7 - Public release
  45.  
  46.      ADDED: Now, ...Select_Active with ...Select_Ask returns the  active entry
  47.             instead of 0.
  48.      FIXED: A selected entry  in a list node does not  memory its state over 2
  49.             or more close/open on this list node (Thx to Andrija Antonijevic)
  50.      FIXED: ...Select_Active ...Select_Toggle  caused an alert  without active
  51.             entry (Thx to Andrija Antonijevic)
  52.      FIXED: After a  MUIA_NListtree_Quiet,  sometimes the  tree was  refreshed
  53.             twice.  This is a very old bug i've forgotten for some weeks. (Thx
  54.             to Sebastian Bauer for reporting it again)
  55.      ADDED: MUIM_NListtree_Clear
  56.      ADDED: Check for outdated NList.mcc.  If version is lower than 19.97, NLt
  57.             aborts.
  58.      REWR:  Rewritten  selection code for  new NList feature.  Attention! With
  59.             a lower  NList version than 19.98,  NListtree disables  his multi-
  60.             selection feature now!
  61.  
  62.  
  63.   V18.6 - Public Beta release 5
  64.  
  65.      FIXED: Fixed bug introduced  with multiselection that  allows dragging of
  66.             entries to  their children  what ends up in a  crash  (reported by
  67.             Sebastian Bauer, thx)
  68.      FIXED: Rewritten entry position calculation code. Never  more  accidently
  69.             deleted entries!
  70.      FIXED: Drop type "Sorted" never occured. Fixed!
  71.      FIXED: Renaming the user field was not possible. Fixed.
  72.      ADDED: Added MUIV_NListtree_Insert_ListNode_ActiveFallback  (see autodocs
  73.             for more details) (suggested by Sebastian Bauer)
  74.      ADDED: Added a  second  find method and  the corresponding hook  for user
  75.             data. This is meant as a backup if  searching for different fields
  76.             and/or values (MUIA_NListtree_FindUserDataHook,
  77.             MUIM_NListtree_FindUserData).
  78.      ADDED: Added  MUIA_NListtree_ShowTree for  enabling/disabling  the  tree.
  79.             This is usefull for lists which can be sorted in different cols.
  80.      ADDED: Added spanish catalog (Thx to Javier de las Rivas).
  81.      ADDED: Added trigger attribute MUIA_NListtree_SelectChange.
  82.      FIXED: Inserting open  nodes into a closed node  caused NListtree to mis-
  83.             calculate the positions (reported by Luca 'Hexaae' Longone, thx).
  84.  
  85.  
  86.   V18.6 - Beta release 4
  87.  
  88.      On the fly-release for some persons.
  89.  
  90.  
  91.   V18.6 - Beta release 3
  92.  
  93.      - Added   MUIA_NListtree_DropType,   MUIA_NListtree_DropTarget   and
  94.        MUIA_NListtree_DropTargetPos.
  95.      - Now, MinLineHeight will only be set when image is heigher than the
  96.        current minimum.
  97.      - When using Next/PrevSelected method and deleting selected entries,
  98.        machine crashes. Fixed.
  99.      - Added   MUIV_NListtree_FindName_Flag_Reverse  (suggested by Thomas
  100.        Igracki)
  101.      - Added MUIV_NListtree_FindName_Flag_StartNode  (suggested by Thomas
  102.        Igracki)
  103.      - Added italian catalog.  Thanks to Andrea Zanellato  for the trans-
  104.        lation.
  105.      - Added NULL pointer check to internal construct/destruct hooks.
  106.      - Added MUIV_NListtree_Remove_TreeNode_Selected.
  107.  
  108.  
  109.   V18.6 - Beta release 2
  110.  
  111.      - Changed look and feel of the mcp.
  112.      - mcc was not closed in mcp. Fixed!
  113.      - Source cleanup.
  114.      - Modifications to the tree drawing functions.  Should look a little
  115.        bit nicer now.
  116.      - Added MUIA_NListtree_CopyToClipHook and MUIM_NListtree_CopyToClip.
  117.        Suggested by Harald Frank.
  118.      - Added an own context menu for copying  strings to clipboard units.
  119.      - Added a  translation  package  for easy  translation of  NListtree
  120.        catalogs.
  121.  
  122.  
  123.   V18.6 - Beta release 1
  124.  
  125.      - MUIV_NListtree_MultiSelect_Shifted now works as expected
  126.      - Crashs/hits on exit (dispose) finally removed!
  127.      - Sorting a closed  node forced entries to  show up. Fixed!  (Thx to
  128.        Thomas Igracki)
  129.      - Reimplemented (oups!)  MUIV_NListtree_GetEntry_Flag_SameLevel  and
  130.        MUIV_NListtree_GetEntry_Flag_Visible (Thx to Thomas Igracki)
  131.      - DoubleClick again: Removed  silly bug  that causes  double notify-
  132.        cation on double click. Hey Matthias: Remove workaround ;-)
  133.      - Added some ball images from Henning Thielmann, thx a lot.
  134.      - Fixed  DropType bug  which caused an eight bit  left shift  of the
  135.        original values.
  136.      - Special image in .mcp was not  ghosted when starting MUI without a
  137.        saved configuration. Fixed. Bumped to V18.6.
  138.      - Without  configuration,  no or a  wrong image  was shown  in tree.
  139.        Fixed! Reported by Harald Frank, thx.
  140.  
  141.  
  142.   V18.5 - Public release
  143.  
  144.      - Added  preparse  string  pointer to  MUIP_NListtree_DisplayMessage
  145.        (suggested by Andrija Antonijevic)
  146.      - Made   drop  types  public  (same  values  as  NList  drop  types)
  147.        (suggested by Sebastian Bauer)
  148.      - MUIA_NListtree_Doubleclick  is now  triggered  if  return  key  is
  149.        pressed (reported by Sebastian Bauer)
  150.      - NULL pointer  will  be  replaced  with "*** NULL POINTER ***" text
  151.        now.
  152.      - Multi test  hook will  now be  launched in  all cases  when  multi
  153.        selecting (reported by Thomas Igracki)
  154.      - Removed bug  in NextSelected  function which  caused returning  of
  155.        trash (reported by Thomas Igracki, thx).
  156.      - Added MUIM_NListtree_PrevSelected (suggested by Thomas Igracki)
  157.      - Added MUIV_NListtree_FindName_Flag_Selected to  only find selected
  158.        entries in MUIM_NListtree_FindName (suggested by Thomas Igracki)
  159.      - Fixed bug in DoubleClick: Setting  DoubleClick to  any other  than
  160.        All has no effect (reported by Mark Harman, thx)
  161.      - Added new DoubleClick value: MUIV_NListtree_DoubleClick_NoTrigger.
  162.        This means, that double clicking  an entry  is disabled  including
  163.        disabled trigger (attribute and method).
  164.  
  165.  
  166.   V18.4 - Broken public release, sorry :((
  167.  
  168.      - Added MUIM_NListtree_InsertStruct
  169.      - Added some new internal attributes and methods ;-)
  170.      - Fixed autodocs a litte bit (reported by Allan Odgaard)
  171.      - Added nesting count to MUIA_NListtree_Quiet (suggested by Allan
  172.        Odgaard)
  173.      - Fixed Enforcer hit when deleting the last list entry in root node
  174.        (reported by Matthias Böcker)
  175.      - Fixed Enforcer  hits when listview  is the active object, no entry
  176.        is active and using cursor left/right
  177.      - Added MUIM_NListtree_Active and MUIM_NListtree_DoubleClick methods
  178.      - Removed PoolWatch-hits (reported by Andrija Antonijevic. Thx!) and
  179.        written the book "Do Not Assume That Making Only Two Small Changes
  180.        In A Function Does Not Affect The Functionality"
  181.      - Removed (hopefully) crash on exit (dispose)
  182.  
  183.  
  184.   V18.3 - Public release
  185.  
  186.      - MUA_NListtree_Quiet  does not work as  expected  (reported by Thomas
  187.        Igracki, Thx!)
  188.      - User defined compare- and findname-hooks crash! Fixed!  (reported by
  189.        Thomas Igracki, Thx!)
  190.      - Now, NListtree is really quiet if MUIA_NListtree_Quiet is set!
  191.      - Reactivation of copied, moved and exchanged entries works better now.
  192.      - OpenAutoScroll now  works as expected,  added  new config  item Open
  193.        scroll (Thx to Matthias Bethke).
  194.  
  195.  
  196.   V18.2 - Public release
  197.  
  198.      - Added multiselection feature
  199.      - Fixed some small cosmetical problems
  200.      - Implemented arrows as MUI images
  201.      - Implemented Copy method
  202.      - Implemented KeepStructure flag for recreation of the complete
  203.        structure in Move and Copy
  204.  
  205.  
  206.   V18.1 - Internal release
  207.  
  208.      - Completely rewritten graphics stuff. Now in all cases predefined and
  209.        precreated images  where used.  This fixes many graphic bugs occured
  210.        in the old 18.0.
  211.      - After deleting an entry,  the old entry  remains internally  active.
  212.        Using this entry crashed the machine. Fixed!
  213.      - Moving   marker   with    the   cursor   keys   did    not   trigger
  214.        MUIA_NListtree_Active. Fixed!
  215.      - When deleting entries, MUIA_NListtree_Active was triggered two times.
  216.        Fixed
  217.      - Deleting  an  entry without  entries  in  the list  caused recursive
  218.        function calling and stack overflow ;-) Fixed!
  219.      - Insertion  had some bugs which  caused the machine to hang or crash.
  220.        Fixed!
  221.  
  222.  
  223.   V18.0 - Initial public beta release
  224.  
  225.