-----------
TSplash 1.5
Released June 22, 1995 (6/22/95)
-----------

	I have written TSplash because I was not satisfied with the splash screen
solutions I have been able to find.  TSplash allows you to EASILY add a
splash screen to your program with minimal code changes.  It supports 256
color bitmaps and the ability to close itself when a mouse button is clicked
or when a key is pressed.

------------------------------
Adding TSplash to your program
------------------------------

- Add the tsplash.rc file to your app's resources.  The splash screen and
  splash bitmap are defined in tsplash.rc.

- Add "TSplash* splash;" to the protected section of you TApplication
  object.

- Add the following code to your InitMainWindow() function (at the end):

. . .
	splash = new TSplash(GetMainWindow());
	splash->Create();
. . .
  This code initiates the splash screen and shows it.  TSplash centers
  itself on the screen by default.

- Add "LRESULT DeleteSplashDlg(WPARAM wParam, LPARAM);" to your app's
  protected section and add "EV_MESSAGE(WM_DELETESPLASHDLG,DeleteSplashDlg),"
  to your app's response table.  Copy the code from the "cut and paste"
  section below and paste it into yours.
		TSplash will post WM_DELETESPLASHDLG (#defined as WM_USER + 1) to your
  app when it is closed by default.  Your app will then know it is OK to
  delete the splash dialog (and free up the memory it uses).  If you supply
  false as the second parameter to TSplash's constructor, TSplash will not
  post the WM_DELETESPLASHDLG when it is closed and you will be able to
  display the splash screen again by calling splash->Create().

---------------------------------------
Changes to TSplash code from 1.0 to 1.5
---------------------------------------

- Added the WM_DELETESPLASHDLG message to free up the memory used by TSplash

- Fixed a few memory leaks present in the TSplash code

- Added ability to reuse the splash dialog after its initial display.  To do
  so, pass false as the second parameter of the TSplash constructor.

	TSplash( GetMainWindow(), false );

->Thanks to Greg Bullock (cis 75322,202) for all WM_DELETESPLASHDLG
->related code and the memory leak fixes!


---------------------
Cut and paste section
---------------------

*************************************************************
*Add this to all files that have TSplash code added to them:*
*************************************************************

	#include "tsplash.h"

*****************************************************************
*Add this snippet to your app's header in the protected section:*
*****************************************************************

	//
	// TSplash
	//

	TSplash*	splash;
	LRESULT DeleteSplashDlg(WPARAM wParam, LPARAM);

*****************************************************
*Add this to your TYourApplication::InitMainWindow()*
*****************************************************
	//
	// TSplash initialization code
	//

	splash = new TSplash(GetMainWindow());
	splash->Create();

*********************************
*Add this to your response table*
*********************************

	 EV_MESSAGE(WM_DELETESPLASHDLG,DeleteSplashDlg),

*********************************************
*Add this to your TApplication's source file*
*********************************************

//
// Code that deletes TSplash
//

LRESULT TYourApplication::DeleteSplashDlg(WPARAM, LPARAM)
{
	if(splash)
		delete splash;
	splash = NULL;
	return (LRESULT)TRUE;
}

------------------------
Getting in touch with me
------------------------

	If for any reason you need to talk to me (bug reports, additions,
suggestions, whatever . . .) just drop me a line.  I frequent the BCPPWIN
and WINSDK forums on Compuserve.  My CIS is 75627,3615.  Don't hesitate to
send me questions or bug fixes, I am here to help!

	Russell Morris
	CIS: 75627,3615
	Internet: 75627,3615@compuserve.com

