Listtree.mcc 0.17 - Documentation
*********************************

Copyright
*********

   Listtree.mcc (C) 1994-97 kMel, Klaus Melchior

   This MUI Custom Class is freely distributable, but copyrighted by me.
This means you may freely copy them as long as you do not charge more
than a nominal fee for copying.  This class may be put on PD disks,
especially on Fred Fish's AmigaLibDisks and Fred's CDROMs.  If you want
to distribute the class you MUST keep this document with it.  The class
and documents must be distributed in their original unmodified form.

   This class cannot be used for commercial purposes without written
permission by the author, this applies also on ShareWare. The author
can not be made responsible for any damage which is caused by using
these programs.


-----------------------------------------------------------------------
These classes is GiftWare. If you like them and use them regularly, you
should consider to send a small donation to the author in order to
honor the work he has put into these programs.

   If you are using these classes in your commercial or Shareware
applications you have to contact me before you do any way of
distribution.
-----------------------------------------------------------------------

   I'm interesting in who is using my class in program, so don't be
hesitate to contact me.

   Send comments, suggestions or bug reports, and the gifts to:

     Klaus Melchior, Schulstrasse 17
     D-52156 Monschau, Germany
     Phone: +49 (0)2472 4710
     
     eMail home: kmel@eifel.oche.de
     eMail work: kmel@et1.etechnik.fh-aachen.de
     www       : http://home.pages.de/~kmel/

What is Listtree.mcc?
*********************

   Listtree is a MUI Custom Class of the Magic User Interface (c) by
Stefan Stuntz.

What you need !
***************

   - MUI >= 3.0 (Version 11), better: MUI3.2

   - Crawling.mcc for preferences

How to install!
***************

     copy Listtree/MUI/Libs/MUI/Listtree.mcc MUI:Libs/MUI/
     copy Listtree/MUI/Libs/MUI/Listtree.mcp MUI:Libs/MUI/
     
     copy Listtree/AutoDocs/MCC_Listtree.doc AutoDocs:
     copy Listtree/Include/MUI/Listtree_mcc.h Include:MUI/
     
     copy Listtree/Oberon/txt/Listtree_mcc.mod
     copy Listtree/Modula/txt/MCCListtree.def

   If you are using MUI < 3.2, you cannot modify the preferences of
Listtree.mcc anymore. This will change if MUI3.2 is released.

History of Listtree.mcc
***********************

      0.1  15.05.94  * first beta release to [ss]
     
           16.05.94  + MUIA_Listtree_SplitChars
                     + MUIA_Listtree_ShowSplitChars
                     + MUIA_Listtree_PreSpace
                     + close drawer closes all entries inside
                     + mem pools
     
      0.2  17.05.94  * beta to [ss]
                     + check click columns
     
           29.12.94  + own images
                     + one column for image & text
                     + Listtree_TreeColumn
     
           30.12.94  + listtree is sorted
                     + display hook
                     + nodes with User-Entry
     
      0.3  31.12.94  * beta to [ss]
     
           01.01.95  + construct/destruct hook
                     + ability to change EndKnot text
                     + MUIA_Listtree_Entries
                     + MUIM_Listtree_GetEntry
      0.4            * beta to [ss]
     
           07.05.95  - destruct hook, enforcer hit removed
     
                     + listtree prefs for MUI3
     
      0.5  12.09.95  * beta to [ss] for MUI3
     
                     > 2 classes now, Listtree.mcc & ListtreeName.mcc
                     + remembers the status of the tree nodes
                     + working well...
     
      0.6  13.10.95  * beta to mailing list
                     + MUIM_Listtree_GetEntry
                     + MUIV_Listtree_Open_ListNode_Parent works
                     * to [ss] for MUI Prefs
     
           14.10.95  - bug in refresh routine, fixed
                     + open, close trees with MUI keys [ill]
                     + open, close active entry is working now
                     + calculate the width of the tree node images
                     + generate the spacing image
     
           15.10.95  + several styles
                     - Win95 works not
      0.7            * beta to mailing list
     
           16.10.95  + New ImageObjects functions for listview by stuntzi
                     + Win95-Area class
                     + New style: Lines
                     + Win95 style works
                     * beta to [cs]
     
           17.10.95  + Default images under MUIv11 works now
                     * beta to [ss]
                     + PopButton for pen of lines
                     - Win95 leaf node draw bug, fixed [ss]
                     - Open_All() bug fixed
                     - _SetUp: space & style not copied, fixed
                     + disable buttons
                     * beta to [ss]
     
           19.10.95  + Win95: plus/minus moved to right [ss]
     
           20.10.95  - check treecolumn after doubleclick removed [ss]
                     + Win95: draw lines, pattern fixed [ss]
                     * beta to [ss]
     
                     - default images, Enforcer hits fixed
                     + new Oberon, Modula2 includes
     
           21.10.95  + SingleClick changes status of nodes [ss]
                     + cycle chain completed
                     + bubble help added
     
      0.8  22.10.95  * beta to mailing list
     
           30.10.95  + new DragNDrop method implemented
                     + Drag&Drop indicator only style 'Lines'
     
           01.11.95  + List indicator, new MUI3
                     + Spacing range from 0 to 16 [ss]
                     + Drag&Drop implemented
                     + Drag&Drop indicator, all styles
                     + MUIM_Listtree_Move (only for visible entries) [rs]
      0.9            * beta to mailing list
     
           07.11.95  + MUIV_Listtree_GetEntry_Flags_SameLevel [rs]
                     - Bug MUIM_Listtree_Remove, Enforcer hit removed [rs]
                     * beta to [rs]
     
           08.11.95  - Prefs sample bug removed [ss]
                     * beta to [ss]
     
           09.11.95  + MUIA_Listtree_Quiet [op] [rs]
                     + Autodocs created, not all!
      0.10           * beta to mailing list
     
           10.11.95  - Bug, after Drag&Drop entry is active [rs]
                     * beta to [rs]
     
           12.11.95  + MUIM_Listtree_TestPos [rs]
                     * beta to [rs] [ss]
     
           14.11.95  + more MUIM_Listtree_GetEntry functions
                     - DoubleClick on leaf, refresh bug fixed [rs]
                     - some private methods removed
                     + more AutoDocs
      0.11           * beta to mailing list
     
           16.11.95  + adapted to MUIv12
     
           17.11.95  + MUIM_Listtree_Rename [rs]
     
           19.11.95  - Set MinHeight of lines, font size < 8 trashes the
                       Win95 style. fixed [ss]
                     - SetUp data now set correctly
                     * beta to [ss] [rs] [ow]
     
           20.11.95  + MUIA_Listtree_DoubleClick
                     + Notify on MUIA_Listtree_DoubleClick
                     - DoSuperMethod at set() fixed
                     + Notify on MUIA_Listtree_DoubleClick on leaves
     
           21.11.95  * MUI 3.1
     
           22.11.95  + MUIM_Listtree_GetNr
     
           23.11.95  + Notify on MUIA_Listtree_Active [op]
     
           24.11.95  - Bug in IsMinListEmpty(), fixed [rs]
                     * beta to [rs]
     
           25.11.95  - Bug in move_node(), wrong display flags, fixed
                     + MUIA_Listtree_SortHook, own hooks are not working
                       yet! [rs]
                     + MUIM_Listtree_Exchange
                     + TPF_MIDDLE exchanges the leaves after D&D
                     + Nodes or leaves can be D&D into other nodes
     
           26.11.95  + MUIA_Listtree_EmptyNodes
                     + Source splitted, now DMake
                     + Autodocs
     
           27.11.95  + Changes in Modula2 & Oberon interface
                     + Autodocs
      0.12           * beta to mailing list
     
           01.12.95  - DisplayOpened fixed
     
           03.12.95  + MUIM_Listtree_DragQuery
                     + MUIM_Listtree_DragReport
                     + MUIM_Listtree_DragDrop
                     - MUIM_Listtree_TestPos
                     + MUIV_Listtree_Insert_Flags_NextNode
                     * beta to [rs]
     
           04.12.95  - exchange nodes, bug fixed
                     + TNF_FROZEN [rs]
                     + TNF_NOSIGN [rs]
     
     
           05.12.95  + MUIA_Listtree_OpenHook
                     + MUIA_Listtree_CloseHook
                     + MUIA_Listtree_SortHook, own hooks [op]
                     * beta to [rs] [op]
     
           07.12.95  + insert entry in closed node, bug fixed [rs]
                     * beta to [rs]
     
           17.12.95  + MUIV_Listtree_Rename_Flag_User
     
      0.13           * internal release for [ow] [rs] [ss]
     
           ........  - MUIM_Listtree_DragQuery removed
                     - MUIM_Listtree_DragReport removed
                     - MUIM_Listtree_DragDrop removed
                     + MUIM_Listtree_FindName
                     + MUIM_Listtree_SetDropMark
                     + MUIA_Listtree_DuplicateNodeName
                     + Listtree.mcc splitted for MUI3.2 & AT
                     + Listtree.mcp
                     - many Bugs fixed [all]
     
      0.14 25.01.96  * beta to several people
     
           31.01.96  + MUIA_Listtree_Changed for Bookmarks.mcc
                     - bugs in GetEntry() fixed
                     - exchange nodes disabled!
     
           ........  - several bugs fixes
                     * MUI3.3, binary only
     
           05.03.96  - MUIA_Listtree_Rename docs fixed [mn]
     
           11.03.96  - entries not freed at dispose, fixed [rs]
     
           ........  - Modula-2 interface bugs fixed [op]
                     - OM_Dispose handling fixed [ss]
     
           23.03.96  > Interface for E included [js]
      0.15           * beta to several people
     
           29.03.96  + drop items on every position of the listtree added
                     - fixed bugs with DuplicateNodeName [js]
                     * beta to [ss] [ow] [rs]
     
           09.04.96  - fixed bug while _Dispose() [sb] [ss]
                     * beta to [ss] [ow] [cd] [sb]
     
           ........  + new internal functions for Bookmark.mcc
                     + MUIA_Listtree_SetDropMark_Values_Sorted
                     + MUIV_Listtree_TestPos_Result_Flags_Sorted
                     + drop objects under the last entry
                     - E interface not ready!
     
      0.16 30.04.96  * beta to several people
     
           07.05.96  + Padrino's coolest prefs image inserted
     
           14.07.96  # bumped to v16
     				* MUI3.5 release, binaries only
     
           08.08.96  - bug, renamed entry wasn't refreshed
                     + MUIV_Listtree_Rename_Flags_NoRefresh
     
           11.08.96  - fixed doubleclick on triangle bug [ow] [sb]
     				* MUI3.6 release, binaries only
     
           13.09.96  - fixed EmptyNodes mode: empty nodes don't react on
                       open/close
                     - fixed SingleClick position if TreeColumn not 0
     
           18.09.96  + MUIA_Version, MUIA_Revision
     
           25.09.96  - fixed GetEntry_Position_Tail bug [sb] [js] []
                     - fixed GetEntry_Position_Next bug [sb] []
                     - fixed Move_Sorted bug [sb]
      0.17b1         * beta to [js] [] [sb] [ss]
     
           26.10.96  + MUIM_Listtree_Sort
                     + recompiled with SAS/C 6.57
      0.17b2         * beta to [ss]
     
           11.01.97  + winter prefs image, thanks to padrino
                     + new style: Lines3D
     
           23.01.97  - bugfix, position of leaves corrected [ss]
                     - Lines3D: enforcerhits removed [lammy]
     				+ default color of the shadow lines is now the shadow
                       pen [lammy]
      0.17b3         * MUI 3.7
     
                     - documentation fixed
     
           18.04.97  + MUIV_Listtree_Move_NewTreeNode_Head
                     + MUIV_Listtree_Move_NewTreeNode_Tail
                     + MUIV_Listtree_Move_NewTreeNode_Active
      0.17b4         * beta to [ss][zc]
     
           21.07.97  + USEDCLASSES implemented
                     - fixed disappearance of Listtree.mcp
      0.17           * release

What is to do in future?
************************

   - Autodocs Methods

   - special images in treecolumn, hook? [ow]

   - Implement flags of different methods

   - installer script

   - Localization

Thanks are going to ...
***********************

   - Stefan Stuntz for his Magic User Interface

   - Olaf Peters for his help with the Modula-2 Interface

   - Frank Dürring for his help with the Oberon Interface

   - Jan Hendrik Schulz for his help with the E Interface

   - Padrino for his cool prefs image

   - Rüdiger Sopp, Markus Illenseer, Oliver Wagner, Michael Nauweiler,
     Jerome Souquieres, Stefan Burstroem, Stefan Sommerfeld

   - and all I forgot to mention ...

Index
*****



 Authors address                        Copyright
 Bug reports                            Copyright
 Comments                               Copyright
 Copyright                              Copyright
 Credits                                Credits
 Description                            Description
 Distribution                           Copyright
 E-Mail                                 Copyright
 GiftWare                               Copyright
 History                                History
 Installation                           Installation
 Requirements                           Requirements
 Thanks                                 Credits
 ToDo                                   ToDo

