home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 March / Chip_1998-03_cd.bin / zkuste / delphi / WhiteAnts / PROGRESS.ZIP / ReadMe.TXT < prev    next >
Encoding:
Text File  |  1997-01-10  |  6.8 KB  |  183 lines
  1. +----------------------------------------------------------------------------+
  2. |                                      ⌐  ⌐                                  |
  3. |                                    ⌐⌐ ⌐ ⌐ ⌐                                |
  4. |                                 ⌐⌐⌐ ⌐   ⌐  ⌐                               |
  5. |                                 ⌐⌐    ⌐ ⌐   ⌐                              |
  6. |                  ⌐             ⌐⌐     ⌐  ⌐                                 |
  7. |                 ⌐ ⌐            ⌐⌐⌐    ⌐⌐  ⌐                                |
  8. |             ⌐⌐  ⌐  ⌐      ⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐  ⌐                                    |
  9. |            ⌐  ⌐⌐  ⌐⌐      ⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐                                  |
  10. |            ⌐ ⌐⌐⌐ ⌐⌐⌐⌐⌐⌐ ⌐⌐⌐ ⌐   ⌐⌐⌐⌐⌐⌐⌐⌐                                   |
  11. |           ⌐ ⌐⌐ ⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐ ⌐   ⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐      Copyright ⌐ 1996-1997 by:  |
  12. |           ⌐ ⌐⌐⌐⌐⌐⌐ ⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐⌐  ⌐ ⌐⌐⌐⌐⌐ ⌐⌐                                 |
  13. |          ⌐ ⌐⌐⌐⌐⌐⌐⌐   ⌐⌐⌐⌐⌐ ⌐⌐⌐⌐    ⌐⌐ ⌐⌐ ⌐      WHITE ANTS SYSTEMHOUSE BV  |
  14. |         ⌐  ⌐⌐⌐⌐⌐⌐⌐ ⌐⌐⌐ ⌐⌐⌐ ⌐⌐ ⌐       ⌐⌐⌐⌐      Geleen 12                  |
  15. |         ⌐ ⌐⌐⌐⌐⌐⌐⌐    ⌐   ⌐⌐   ⌐⌐⌐       ⌐       8032 GB Zwolle             |
  16. |           ⌐⌐⌐⌐⌐⌐     ⌐            ⌐ ⌐           Netherlands                |
  17. |      ⌐⌐⌐  ⌐⌐⌐⌐⌐      ⌐     ⌐⌐     ⌐  ⌐                                     |
  18. |            ⌐⌐       ⌐              ⌐  ⌐⌐⌐ ⌐     Tel. +31 38 453 86 31      |
  19. |      ⌐              ⌐              ⌐            Fax. +31 38 453 41 22      |
  20. |      ⌐             ⌐               ⌐⌐                                      |
  21. |    ⌐              ⌐                  ⌐⌐         www.whiteants.com          |
  22. |  ⌐⌐              ⌐                     ⌐ ⌐      support@whiteants.com      |
  23. |                 ⌐                                                          |
  24. +----------------------------------------------------------------------------+
  25.  
  26.  
  27.  
  28.                         P R O G R E S S O R   1.0
  29.                         =========================
  30.  
  31.  
  32.  
  33. CONTENTS
  34. --------
  35. * History
  36. * Introduction
  37. * Description
  38. * Files
  39. * Install
  40. * White Ants
  41. * Technical Support
  42. * How To Reach Us
  43.  
  44.  
  45. HISTORY
  46. -------
  47. Jan 10, 1997 - Initial Release 1.0
  48.  
  49.  
  50. INTRODUCTION
  51. ------------
  52.  
  53. Progressor 1.0 is Freeware (more info see Disclaim.txt) and contains a helpful
  54. 16 bit Delphi component TProgressObserver which co-operates with a TProgressor
  55. class. These classes let you detach low level progress status and change
  56. notifications from the GUI. Note that this is NOT a visual component such as
  57. TGauge, but rather an GUI detached interface for starting, running, aborting
  58. and finishing lengthy operations. A demo project PROGDEMO is included which
  59. demonstrates the use of the TProgressObserver.
  60.  
  61.  
  62. DESCRIPTION
  63. -----------
  64.  
  65. The TProgressor and TPorgressObserver classes let you decouple the status of
  66. lengthy operations from the GUI. This is achived by use of an GUI-Clean
  67. TProgressor class and an Observer pattern (TProgressObserver).
  68.  
  69. TProgressor is a singleton class which can be accessed only by it's Instance
  70. class function. (e.g. TProgressor.Instance). You will never to create or free
  71. an instance this class, it's all done for you as soon as you access it.
  72.  
  73. TProgressor has four progress controlling main properties:
  74. - Progress (usually percentage completed)
  75. - Description (about what's going on)
  76. - The Aborted state of an operation (including the Application.Terminated:
  77.   Aborted returns True if the user has terminated the application or set abort
  78.   True)
  79. - BusyCursor, which is passed on to the Screen.Cursor. Any other value than
  80.   crDefault will change the cursor to this value for the whole screen.
  81.  
  82. There are some methods which control the multi level progress status:
  83. - StartProgress, (or StartProgressDef)
  84. - EndProgress use these methods in pairs to start and end a (sub)level of
  85.   progress
  86. - Abort (sets Aborted True)
  87.  
  88. TProgressor has no events of it's own, but uses TProgressObserver instances
  89. to dispatch events. TProgressObserver automatically registers and unregisters
  90. itself with the TProgressor.
  91.  
  92. The dispatched events are:
  93. - OnDescriptionChange, you can e.g. handle this event to update some label
  94.   telling the user what's going on
  95. - OnProgressChange, you can e.g. handle this event to update the status of the
  96.   progress of an operation, e.g. update a gauge
  97. - OnStart,
  98. - OnFinish, you can use these events to reflect the busy status, e.g. make the
  99.   progress gauge visible / invisible.
  100.  
  101. TProgressObserver wraps the status properties and methods from TProgressor
  102. (therefore all observers do have the same value for BusyCursor etc.)
  103.  
  104. Each TProgressObserver instance has it's own accuracy property which defines at
  105. which rate (0..50) you'll get the OnProgressChange events. Set this to 1 to get
  106. notified about each change.
  107.  
  108.  
  109. FILES
  110. -----
  111.  
  112. Main files
  113. - README.TXT    This file
  114. - DISCLAIM.TXT  The file containing the disclaimer for Progressor
  115. - PROGRESS.PAS  contains TProgressor and TProgressObserver classes
  116. - PROGRESS.DCR  contains Delphi Component Resource File for TProgressObserver
  117. - INTLISTS.PAS  contains TIntList, a dynamic array of LongInts used by PROGRESS
  118. - NUMUTILS.PAS  contains numeric utilities used by PROGRESS
  119. - STRUTILS.PAS  contains string utilities used by PROGRESS
  120.  
  121. Demo
  122. - PROGDEMO.DPR  Delphi project file
  123. - PROGDEMO.RES  Delphi project resource file
  124. - MAINFRM.PAS   Main form unit file
  125. - MAINFRM.DFM   Main form resource
  126. - DEMOOPS.PAS   Contains a LengthyOperation procedure which simulates activity
  127.  
  128.  
  129. INSTALL
  130. -------
  131.  
  132. - Unzip PROGRESS.ZIP, for example in directory c:\PROGRESS
  133. - BEFORE you open the project file PROGDEMO.DPR you must install the unit
  134.   Progress.pas in the component palette.
  135.   (Delphi 1.0: Options|Install Components|Add...)
  136. - Open the project file PROGDEMO.DPR and compile the project
  137.  
  138.  
  139. WHITE ANTS
  140. ----------
  141.  
  142. White Ants systemhouse BV is specialised in developing software in Borland
  143. Delphi for all Microsoft Windows platforms.
  144.  
  145. Our main activities are:
  146.  
  147. 1) Turnkey building of customer specific software.
  148.    Varying from single applications to complex real-time distributed computer
  149.    systems and multi-tier client/server solutions.
  150.  
  151. 2) Tools and components for professional colleague software developers.
  152.    Including the Delphi CASE tool ModelMaker.
  153.  
  154.  
  155. Visit our website for information about us and our latest tools and components:
  156.  
  157.    www.whiteants.com
  158.  
  159. Or e-mail us at info@whiteants.com
  160.  
  161.  
  162. TECHNICAL SUPPORT
  163. -----------------
  164.  
  165. Please e-mail us at support@whiteants.com if you have any problems or find any
  166. bugs in this code.
  167. We do not offer support on our FREEWARE by telephone, fax or letter.
  168.  
  169.  
  170. HOW TO REACH US
  171. ---------------
  172.  
  173. White Ants systemhouse BV
  174. Geleen 12
  175. 8032 GB Zwolle
  176. Netherlands
  177.  
  178. Tel. +31 38 453 86 31
  179. Fax. +31 38 453 41 22
  180.  
  181. www.whiteants.com
  182. support@whiteants.com
  183.