Woodstock Computer Solutions Delphi components
----------------------------------------------

{----------------- DISK CONTENTS -------------------------}

This Main ZIP archive is called WCSDCDIR.ZIP.
It should contain the following files : 

WCSREAD.TXT  (This file!)
DCDIR16.ZIP (Delphi 1 components) Containing :
  DCDIRSRC.DCU (Recursive directory search and dialog components)
  DCDIRSRC.DCR (Component Resource file for the above)
  WCSABOUT.DCU (Needed by WCSDIRSRC, includes Help for component)
  WCSABOUT.DFM (Form file for above)
DCDIR32.ZIP (Delphi 2 components) Containing :
  DCDIRSRC.DCU (Descriptions as above...)
  DCDIRSRC.DCR 
  WCSABOUT.DCU 
  WCSABOUT.DFM 
DCDIREX.ZIP (Delphi 1 or 2 Example project)
  WCSEXAMP.PAS (Example usage unit)
  WCSEXAMP.DFM (Example usage unit form file)
  WCSEXAM.DRP  (Example usage project)


The source (See end of this file) of both components
will work in Delphi 1 or 2.
(and who knows, maybe 3, 4 etc when they arrive!)

{------------------ THE COMPONENTS -------------------------}

TWCSDIRSEARCH
-------------
A recursive directory searcher with events on finding files
or subdirectories, and a completion event.
The properties and methods are described in the "dsAbout"
property (click the three dots or press Ctrl-Enter when
highlighted.

IMPORTANT NOTES:

1. Bear in mind that after you call the "Execute" method, the
search will start, and your code will continue to execute.
The example unit shows how you can deal with this, if you
want to wait for completion.

2. If you create or delete files in the event handlers,
or before the search is complete, you will cause the search to
lose it's place. The example unit shows how you should build
a list of files and then deal with them later.


TDIRDIALOG
----------
This is just a wrapper for the "SELECTDIRECTORY" procedure,
but helps to keep things consistent with TFileOpenDialog etc.
To use it, just call the "Execute" method exactly as with other
file dialogs, which will return true if a valid directory is
selected. If "Execute" returns "True", the "Directory" property
contains the selected directory (WITHOUT trailing backslashes).


{------------- INSTALLATION -----------------------------}

Unzip the secondary archives into a temp directory.

Select the 16 or 32 bit version as required.
Unzip the 4 files : 
	DCDIRSRC.DCU
	DCDIRSRC.DCR
	WCSABOUT.DCU
	WCSABOUT.DFM
to your component source or library directory.

Follow your usual procedure for component installation,
and Add DCDIRSRC.DCU which contains the registration.

The Registration creates a WCS pallette entry.

If you have not installed components before,
rough guideleines are :
1. Make a backup copy of your component library file
(COMPLIB.DCL or CMPLIB32.DCL on LIB diretory)

2. Unzip the files as descrbed above to a new directory,
remembering to select the correct 16 or 32 bit Zip file.
(Use a short name for the directory path, as the 
Delphi component search path is of limited length)

3. Choose "Options|Install Components..." (v1) or
"Comonents|Install..." (v2).

4. Click "Add..." and "Browse" to the directory used 
in step 2.

6. Change the file filter to ".DCU" files and 
select DCDIRSRC.DCU, and OK.

7. Select OK on the main component install dialog and
your library will start to rebuild. When complete,
you should have an extra tab on the component pallete
called WCS.

{--------------- THE EXAMPLE ---------------------}

The example project should be unzipped into it's 
own new directory and compiled. It simply shows how
to use the main component to gather a tree list of
files and subdirectories starting at a given
directory (selected using the second component).

{--------------- SOURCE CODE ---------------------}

This compiled component is provided as Freeware.
The Zip File can be distributed freely as long as
the contents are not modified.

There are additional non-visual components and
routines (such as a directory tree deletion object)
in the units supplied, but these are only documented 
in the source code.

If you would like to see the source, please send
a cheque to :
	Woodstock Computer Solutions Ltd
	Malvern
	Oakhanger
	Bordon
	Hampshire 
	GU35 9JJ
Price (Please specify media):
	On Disk    : 10
	via e-mail : 8

Please note, distribution of the source code other
than by Woodstock Computer Solutions is a violation
of copyright and illegal.

{----------------- END ------------------------}
