+----------------------------------------------------------------------------+
|                                                                          |
|                                                                       |
|                                                                      |
|                                                                       |
|                                                                       |
|                                                                    |
|                                                             |
|                                                        |
|                                                      |
|                       Copyright  1996-1997 by:  |
|                                                  |
|                           WHITE ANTS SYSTEMHOUSE BV  |
|                            Geleen 12                  |
|                                  8032 GB Zwolle             |
|                                        Netherlands                |
|                                                               |
|                                         Tel. +31 38 453 86 31      |
|                                              Fax. +31 38 453 41 22      |
|                                                                        |
|                                             www.whiteants.com          |
|                                            support@whiteants.com      |
|                                                                           |
+----------------------------------------------------------------------------+



                        WinTaskBar Component

                            version 1.10

                       for Delphi 2.0 upwards

           for managing an icon in the Notification area 
                       of the Windows taskbar

              Win32 (Windows95 or NT 4.0 upwards) ONLY

                        ====================



CONTENTS
--------
* History
* Introduction
* Description
* Limitations
* Files
* Install
* White Ants
* Technical Support
* How To Reach Us



HISTORY
-------

Mar 10, 1997 - Update 1.10
               Minor reorganisation in classes.
               Now internal filtering second OnClick after a OnDblClick
               Bugfix: second OnClick after OnDblClick modal BEHIND application
               Bugfix: application didn't close on a windows close

Feb 14, 1997 - Initial Release 1.0



INTRODUCTION
------------

The WinTaskBar Component is a Delphi 2.0 Component for adding and managing an
Icon in the Windows Taskbar Notification area of the Windows95 or Windows
NT 4.0 Taskbar.

With WinTaskBar you can put an icon in the area left from the timer in the
Windows taskbar. E.g. for informing the user that a process is active in the
background. The user can then interact with this process by this icons pop-up
menu etc.

Or use it for hidden background applications.


DESCRIPTION
-----------

The Unit WTASKBAR.PAS contains the TWinTaskBar component which has a small
interface enabling you to do what Windows expect you to do with Icons in the
Taskbar Notification area:

  - show, hide or change an icon
  - show or change a hint when the user stops the mouse above the icon
  - show a pop-up menu when right clicking the icon
  - react on (clicking and) double-clicking the icon

For this the TWinTaskBar component has the properties:

  - Hint       : the hint shown when stopping the mouse on the icon
  - Icon       : the icon to show in the taskbar
  - PopUpMenu  : the pop-up menu to show on a right click
  - ShowIcon   : show or hide the icon

And the events:

  - OnClick    : user is clicking on the icon
  - OnDblClick : user is double clicking on the icon

Properties and event can be set at design-time or (changed) at runtime. If you
need more icons on the taskbar use more WinTaskBar components!

If you want more control or fool around at the level of win32 API use
TCustomWinTaskBar instead of the TWinTaskBar.

See the WinTaskbarTest.DPR project as an example of how to use the component.


LIMITATIONS
-----------

Using the click event together with the double-click event is a bit a pain in
Windows: by design - Microsoft always says. On double clicking you get two(!)
click events and one double click event. And the two click events you probably
don't want. The last one is filtered by the component, but not the first one.

The normal solution for this is messing around a bit with a timer to filter out
the first click event. See an example of this in the WinTaskbarTest example.

We also had to solve another - by design - feature (we normally call it bugs or
anomalies) of Microsoft with the pop-up menu. For this we have to send a dummy
message (we use WM_USER, 0, 0) to the owner form of the component. 

Advise: If you don't have to, don't use the single and double click together.


FILES
-----

Main files:
- README.TXT    This file
- DISCLAIM.TXT  The file containing the disclaimer
- WTASKBAR.PAS  contains TWinTaskBar and TCustomWinTaskBar components
- WTASKBAR.DCR  VCL pickie for TWinTaskBar

Example:
- WinTaskBarTest.DPR  Example project
- WinTaskBarTest.RES
- TestFrm.PAS
- TestFrm.DFM

White Ants ModelMaker Model files (compatible with MMWin 3.20 upwards)
- WTASKBAR.MPR .MMB .MMC .MMD .MME:


INSTALL
-------

- Unzip WTASKBAR.ZIP.
- Install the unit WTASKBAR.PAS in your component library.
- For using the MM-Models, White Ants ModelMaker needs the alias:
  'WorkDir' set to the directory to generate the OPascal code.


WHITE ANTS
----------

White Ants systemhouse BV is specialised in developing software in Borland
Delphi for all Microsoft Windows platforms.

Our main activities are:

1) Turnkey building of customer specific software.
   Varying from single applications to complex real-time distributed computer
   systems and multi-tier client/server solutions.

2) Tools and components for professional colleague software developers.
   Including the Delphi CASE tool ModelMaker.


Visit our website for information about us and our latest tools and components:

   www.whiteants.com

Or e-mail us at info@whiteants.com


TECHNICAL SUPPORT
-----------------

Please e-mail us at support@whiteants.com if you have any problems or find any
bugs in this code.
We do not offer support on our FREEWARE by telephone, fax or letter.


HOW TO REACH US
---------------

White Ants systemhouse BV
Geleen 12
8032 GB Zwolle
Netherlands

Tel. +31 38 453 86 31
Fax. +31 38 453 41 22

www.whiteants.com
support@whiteants.com
