+*****************************************************************************+
|                                                                             |
|                         TQuickSelect v1.5                                   |
|                                                                             |
|        Delphi 2.0 VCL Component for visual creation of SQL-queries.         |
|        Enables the user to create SQL-queries by simply putting             |
|        together English sentences with the mouse.                           |
|                                                                             |
|        The component is also available for Delphi 3, 4 and 5                |
|                                                                             |
+*****************************************************************************+
|                                                                             |
| TrollSoft                                                                   |
| Haugerudbraatan 15                                                          |
| 3408 TRANBY                                                                 |
| Norway                                                                      |
|                                                                             |
| EMail..........: quickselect@trollsoft.com                                  |
| Home...........: http://www.trollsoft.com                                   |
| Order Source...: https://secure.element5.com/register.html?productid=106079 |
|                                                                             |
+*****************************************************************************+


Introduction:
=============

The idea for this component came when I was making a program where 
the user should be able to make his own selection of data, which in 
turn would be presented in various ways. I started to look at 
ReportSmith, but soon found that it was way to complex (and slow) for 
my needs. What I needed was an easy and fast way to make SQL-queries,
and then use these queries together with e.g. TQuery and TQuickReport 
components. The result is TQuickSelect where the user can make 
queries by constructing English sentences, which is then converted to 
SQL. The component is also translated to Norwegian, Spanish, French
and German. Please contact me if you're interested in translating 
the component to your own language. If you don't own a resource 
editor, I'll send you an uncompiled resourcefile, so you can 
translate the component in a texteditor.

The component is Freeware, and you are free to use it in any way you 
please. All I ask is that you EMail (or SnailMail) me to tell me what 
you think of it, bugs, wanted features etc. Also if you use this 
component in a program that you make a lot of money on, I would'nt
mind if you shared some of it :)

If you are interested in the source, please EMail me and we might 
come to an agreement. 



Files:
======

QSReg       PAS  -> This unit is used to register the QuickSelect 
                    component, and its property editors, with 
                    Delphi 2.0. The QSComboBox component will also
                    be installed by this unit.
                    See "Installation" below for more information.

QSStrings   PAS  -> This unit contains the declaration of string 
                    constants used by the TQuickSelect component.
                    This unit is also used to determine the 
                    language for the component. Open the file in 
                    the editor for further instructions.

QuickSelect DCU  -> This unit contains the declaration and 
                    implementation of the TQuickSelect component 
                    class.

UCommon     DCU  -> This unit contains types, variabels and routines 
                    used in many of the other units.

UQuickSelectDlg DCU/DFM  -> This unit implement the dialog where the
                            user create the query.

UReportTypesDlg DCU/DFM  -+  
UTablesDlg      DCU/DFM   |
UJoinsDlg       DCU/DFM   |    
UFieldsDlg      DCU/DFM   +-> These units implement the various 
UEditMaskDlg    DCU/DFM   |   propertyeditors, and dialogs.
UNameDlg        DCU/DFM   |
USortDlg        DCU/DFM  -+

QSEng           RES  -> Stringresource in English
QSNor           RES  -> Stringresource in Norwegian
QSFre           RES  -> Stringresource in French
QSSpa           RES  -> Stringresource in Spanish
QSGer           RES  -> Stringresource in German
QSReg           DCR  -> Dynamic Component Resource with the component 
                        icon 
UQuickSelectDlg RES  -> Resourcefile for the QuickSelect dialog

QSelect      HLP  -> Helpfile. See "Installation" below.
QSelect      KWF  -> Keywordfile. See "Installation" below.

QSComboBox  PAS  -> The sourcefile to TQSComboBox. This component is 
                    an example of how you can let the user access the
                    reports without launching the dialog.
Demo        DPR  -+   This is a small demonstration of TQuickSelect
MainFrm     DFM   +-> and TQSComboBox
MainFrm     PAS  -+   (These 3 files are located in the Demo directory)

History     TXT  -> The history of TQuickSelect. This file contains
                    a list of all the changes done to TQuickSelect
                    from v1.0 to v1.5
ReadMe      TXT  -> This file

                    

Upgrade from any previous version:
==================================

1. Uninstall any previous versions of TQuickSelect.

2. Delete any prevous versions from the disk, and follow the 
   installations below.

3. To update the helpfile, you'll have to start the Help File Installer
   (Helpinst.exe), open "Delphi.hdx", specify the search paths, 
   and compile/save.



Installation for the first time:
================================

To install the component follow these steps:

1. Read the instructions in "QSStrings.pas" first, if you want
   another language than English in the TQuickSelect dialog.

2. In the IDE go to the "Component" menu and select "Install..."

3. Click "Add..." and then "Browse" to find the file "QSReg.pas". 
   This file will install the component and all its propertyeditors. 
   Click "Open".

4. Click OK.

5. After Delphi finishes compiling the Component Library you should
   see a "QuickSelect" button on the "QuickSelect" tab.

6. Now just drop it onto a form and use it like any other component.



To install context-sensitive help for TQuickSelect follow these steps:
======================================================================

1. Shut down Delphi if it's running.

2. Start the Help File Installer program 
   (...\Delphi 2.0\HELP\Tools\HelpInst.exe)

3. Open Delphi's master help index file (...\Delphi 2.0\Bin\Delphi.hdx)
   It is a good idea to make a bacup of this file first!

4. Click the Add button (the button with a "+"), and locate the
   QSelect.kwf file in your TQuickSelect directory. 

5. Due to a bug in HelpInst.exe, it doesn't save the Search Paths to 
   the .KWF files, so you have to specify this every time you install
   a new Keyword File. Go to the "Options" menu and select 
   "Search paths...", and type in the search paths to the .KWF files.
   (The Search path to the .KWF-files suplied with Delphi is
    "?:\borland\delphi 2.0\help" if you use the default directories).
    Separet each path with a ";".

6. Save and exit HelpInst.exe
   
7. Next time you start Delphi you can use F1 with TQuickSelect, as you 
   do with any other component. If you get a warning telling you that 
   Delphi can't find the QSelect.hlp file, just click "Yes" to find the 
   file manually in the TQuickSelect directory. Delphi will remember 
   the location for later use.


We hope you will enjoy using the component as much as we enjoyed making it. 
We look forward to hearing from you soon!

Regards,

TrollSoft
quickselect@trollsoft.com