        TDispatcher Component.
        ---------------------
        (Version 1.01 for Delphi 1, Delphi 2, Delphi 3 and C++Builder)

    CONTENTS

1. What is the TDispatcher Component?
2. Files Supplied
3. Installing the TDispatcher Component
4. Installing the Help File
5. Registration Information
6. Contact


         1.  What is the TDispatcher Component?
         -------------------------------------

  The TDispatcher component is a tool for deferred activation of desired action.
It is a nonvisual component capable of activating procedures after all
previously occurred events are processed.
  Using TDispatcher component you can schedule your procedure for execution
after completion of current event processing but before your application
enters wait state.
  With TDispatcher, you can schedule your procedure for multiple executions;
each of them starts after completion of current event processing but before
your application enters wait state. You can also supply a pair of specific
arguments -- first of string type and second of TObject type for each
execution of your procedure.
  If you need to schedule procedure for single execution and don't need
any argument for it then you may use more simple TResumer component instead.

( Computer Science note -:)
  TDispatcher component facilitates indirect call of a procedure with which
the procedure is called from the top of the stack and therefore doesn't return
to indirect-caller.
  Using TDispatcher component one can implement some form of iterators in
Delphi. These iterators are based on messages and events and permit passing
objects as event parameters and gives a programmer direct control on
TDispatcher's internal event queue.

A Note About TDispatcher's Demo.
---------------------------------
  The demo supplied shows manipulation with TDispatcher's queue and effects
of these manipulations.
  Certainly, it doesn't show principal "call from the top of the stack"
feature  -- I don't know how one can demonstrate this essentially system
feature visually.


         2. Files Supplied
         -----------------

   README.TXT      This file
   DISPTCH.HLP    The help file
   DISPTCH.KWF    The keyword file

   Directory DELPHI1 - Installation files for TDispatcher component for DELPHI 1
      DISPTCH.DCU
      DISPTCH.DCR

   Directory DELPHI2 - Installation files for TDispatcher component for DELPHI 2
      DISPTCH.DCU
      DISPTCH.DCR

   Directory DELPHI3 - Installation files for TDispatcher component for DELPHI 3
      DISPTCH.DCU
      DISPTCH.DCR

   Directory CBUILDER - Installation files for TDispatcher component for C++Builder
      DISPTCH.DCU
      DISPTCH.DCR
      DISPTCH.OBJ
      DISPTCH.HPP

   Directory DEMO - Demo project for DELPHI 
      PICTURES\*.bmp
      PROJECT1.DPR
      UNIT1.DFM
      UNIT1.PAS
      UNIT2.DFM
      UNIT2.PAS
      DEMO1.EXE - executable produced with Delphi 1

   Directory DEMO-CB - Demo project for C++Builder
      PICTURES\*.bmp
      PROJECT1.CPP
      UNIT1.CPP
      UNIT1.DFM
      UNIT1.H
      UNIT2.CPP
      UNIT2.DFM
      UNIT2.H
      PROJECT1.MAK
      PROJECT1.RES

         3. Installing The TDispatcher Component.
         --------------------------------------

  1. The Register procedure in DISPTCH.DCU is set to place TDispatcher on
     the palette page tab named "System". 
  2. If you have installed an earlier version of TDispatcher, be sure and 
     remove it from COMPLIB.DCL (use the Remove button in the Install 
     Components Dialog).  The old files should be deleted or otherwise made 
     unaccessible before doing the new installation.
  3. Pick a directory for the TDispatcher component.  Put
     DISPTCH.DCU and DISPTCH.DCR in the chosen directory.
  4. From the Delphi IDE, choose "Options | Install Components" - for Delphi1
     or "Components | Install" - for Delphi2.  In the dialog choose the "Add"
     button.  In the Add Module dialog that then comes up, the simplest 
     approach is to use the "Browse" button to find DISPTCH.DCU.  Then 
     hit OK and the Search Path edit box will have the correct path added and
     TDispatcher will be added to the installed units listbox.  (You may
     have to scroll down to see it.)
  5. Hit OK on the Install Components dialog and the necessary steps will be
     taken to do the installation.  The TDispatcher button will appear on
     the SYSTEM component page tab.

         4. Installing the Help File.
         ----------------------------

The file DISPTCH.HLP will supply context sensitive help for the
TDispatcher component.

  1. Place the DISPTCH.KWF file in the DELPHI\HELP directory along with 
     the other .KWF files.
  2. Close the Delphi IDE.
  3. Run Delphi's HELPINST program.  Choose File | Open to open
     DELPHI.HDX in the DELPHI\BIN directory.
  4. Choose Keywords | Add Keyword File to add the DISPTCH.KWF file
     to the list of .KWF files.
  5. Choose File | Save or hit the blue disk button to compile and save the
     revised .HDX file.
  6. Now it remains to set things up so that WINHELP can find the help file
     DISPTCH.HLP.  There are several choices:
        - Put DISPTCH.HLP in the DELPHI\BIN directory - for Delphi1 or in
          DELPHI\HELP directory - for Delphi2 with the other help files.
        - Put DISPTCH.HLP somewhere on your path.
        - Modify WINHELP.INI to add a directory entry for DISPTCH.HLP.

The DISPTCH.HLP file contains documentation on how to use the TDispatcher
component.  To access the help, open the help file from Delphi, press 
the "Search All" button and search for "TDispatcher".  
Or place a TDispatcher component on your form and press F1.


         5. Registration Information.
         ----------------------------

By registering you will be entitled to

  - receive complete source code by e-mail
  - free upgrades
  
In order to register, send a check or cash for $20 payable to

        Tarkvara Inc.
        978 Westlynn Way #1
        Cupertino CA 95014
        USA

along with e-mail specifying your name and e-mail address.

Alternatively, you may use a credit card for registration via PsL service.

  You can register the TDispatcher component  over the Internet
  from PsL (product #30615) with any major credit card. As soon
  as PsL  notifies me that your order has been  processed,
  I will send you complete sources of the TDispatcher component.
  Use one of the following URLs:

    https://www.pslweb.com/cgi-win/psl_ords.exe/ITEM30615

  (Secure ordering: If your browser supports secure transactions, try
   this link first.)

    http://www.pslweb.com/cgi-win/psl_ord.exe/ITEM30615

  (Non-encrypted ordering: If your browser does not support secure
   transactions, use this link.)

    http://206.109.101.6/cgi-win/psl_ord.exe/ITEM30615

  (Backup server: If the server above is not accessible, use this
   order server.)


         6. Contact.
         -----------
Elena Lisenenkova
e-mail: ll@center.spb.su

