K&J TRAY ICON (Native Delphi 2.0 VCL)
by Joseph C. Keller
 1996

--------
CONTENTS 
--------
The contents of your .ZIP file should include these eleven (11) Files:
(K&J TRAY ICON COMPONENT FILES)
	KJTrayIcon.dcr
	KJTrayIcon.dcu

(DEMO APPLICATION USING THE K&J TRAY ICON CONTROL)
	TrayIconDemo.dpr	TrayIconDemo.dof
	uMain.pas		uReadMe.pas
	uMain.dfm		uReadMe.dfm
	uMain.dcu		uReadMe.dcu

(NOTES & STUFF)
	ReadMe.txt


*** Note: All source code to the demo has been included within 
	  the .ZIP file.  I have found that viewing the demo
	  source code is the quickest way to understanding the
	  K&J Tray Icon component's properties and methods.
	  After viewing the demo source code, most of this
	  documentation can be skipped or browsed lightly.

----------------
PRE-INSTALLATION
----------------
Make sure the .DCU and .DCR files exist within the same directory.

To be safe, make a backup copy of your current Delphi component
library (CompLib.DCL), usually located in the '\Delphi\Bin\' 
directory.


----------------------
COMPONENT INSTALLATION
----------------------
To install your K&J Tray Icon Control, start by selecting
'Install' from the 'Component' menu.  The Install Components
dialog box will appear on your screen.

Next, click the 'Add' button to open the Add Module dialog box.  In
this dialog box you can either use the 'Browse' button to locate the
K&J .DCU file unit or type the path and name in the edit box.

If the unit in question is located on a path not currently included in
the search path, Delphi will automatically take care of appending the
new path to the search path. (Take note, however, that the maximum size
of the search path is only 125 characters.  If the search path contains
more than 125 characters, you will encounter a compiler error when
trying to rebuild your component library.)

After adding the K&J Tray Icon .DCU unit, click 'OK' in the Install
Components dialog box and Delphi will rebuild its component library and add
a new 'K&J' page to your component palette.  Clicking on the 'K&J'
component page will reveal a new control - 'KJTrayIcon'.


----------------------
PROPERTIES AND METHODS
----------------------
PROPERTIES:
The K&J Tray Icon contains nine (9) properties - most accessible both
at design and run time.
  
PROPERTY NAME	TYPE		ACCESS 		PURPOSE
-------------	----		------		-------
About  	   	Read only 	Design		Displays current version number
						and registration status.

Hint		String     	Design / Run	Determines what text is present
						when the user's mouse rests over
						the displayed icon.  Text is
						limited to 64 characters in size.

Interval	Cardinal   	Design / Run	Determines the animation interval
						(see METHODS).

Icon1		TIcon      	Design / Run	K&J Tray Icon can hold up to five (5) icons.
Icon2		"		"		Used for both single icon display and 
Icon3     	"		"		animation (see METHODS).
Icon4     	"		"
Icon5     	"		"

PopupMenu	TPopupMenu 	Design / Run	Determines what pop-up menu, if any,
						that will be displayed when the user
						right-clicks on the displayed icon.
						To set a default menu item (i.e. bold-
						facing all of the characters on a line),
						place a "*" character as the first entry
						within the line.  It is up to the 
						developer to code the event handler
						for the default menu item.


METHODS:
The K&J Tray Icon contains four (4) methods for displaying icons - all are procedures.

METHOD NAME		PARAMETERS		PURPOSE
-----------		----------		-------
DisplayIcon     	const Index: integer	Displays the icon in the position
						indicated with the "Index" parameter
						within the Windows 95 Taskbar Tray.

RemoveIcon		<None>			Removes the currently displayed icon.

StartAnimation 		const StartIndex,	Begins by displaying the icon referenced in 
		 	EndIndex: integer	the "StartIndex" parameter and then cycles
						through each icon, upon the specified
						interval (see PROPERTIES), until it reaches
						the "EndIndex".  The animation will continue
						in this fashion until the procedure
						StopAnimation is called.

StopAnimation		<None>			Stops the currently running animation.  If
						an icon was present before StartAnimation
						was called, it will be displayed.  Otherwise,
						all icons will be removed from the Taskbar
						Tray.


----
DEMO
----
To see the K&J Tray Icon component in action, run the accompanying
demo - TrayIconDemo.EXE.  All source code to the demo application
has been included within the .ZIP file.  Please open the 
TrayIconDemo.DPR project file to view the K&J Tray Icon component
in action.


----------------------------
REGISTERED VS. UN-REGISTERED
----------------------------
Please be aware that the un-registered version of K&J Tray Icon will only
work within the Delphi 2.0 IDE.  That is, Delphi 2.0 must be running for
K&J Tray Icon to work properly.  This gives you, the developer, an excellent
opportunity to try out K&J Tray Icon before you buy.  If you attempt to
run K&J Tray Icon from outside the Delphi 2.0 IDE, you will see a friendly
message box displayed every time you call one of the methods and the method
will not execute.  This is the only effect you will encounter with running
K&J Tray Icon outside of the Delphi 2.0 IDE.


--------
ORDERING
--------
To receive your registered version of K&J Tray Icon (and avoid those
annoying nag screens), send $15.00 (U.S.) to:

	JOSEPH C. KELLER
	681 ROBBINANN DR.
	WATERFORD, MI  48328-2346
	UNITED STATES

Any questions, comments or suggestions should be directed to either my
Internet or CompuServe account.

Thank You,

Joseph C. Keller

INTERNET:       jkeller@mail.coast.net
COMPUSERVE:     103256,2165
WORLD WIDE WEB: http://www.coast.net/~jkeller


------------------------------
FOR ANY ADDITIONAL INFORMATION
------------------------------
Please see the "About" property within the K&J Tray Icon component.


---------
ADDITIONS
---------
If you would like to see a feature (or two) added to the K&J Tray Icon
component, please feel free to get in contact with me at one of the
above listed addresses.


--------------------------
FOR MORE K&J COMPONENTS...
-------------------------- 
Visit the author's home at the "Temple of Delphi".  The Temple includes
up-to-date versions of all K&J components, links to other Delphi sites
and other valuable information.  Point your browser to
"http://www.coast.net/~jkeller" and enjoy the ride!


----------------
LEGAL DISCLAIMER
----------------
THE INFORMATION AND CODE PROVIDED HEREUNDER (COLLECTIVELY REFERRED TO AS
"SOFTWARE") IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS 
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL 
JOSEPH C. KELLER BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT,
INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL
DAMAGES, EVEN IF JOSEPH C. KELLER HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF
LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING
LIMITATION MAY NOT APPLY.
