===================================================
DBTableFilter component v1.03 - by L&S Software
===================================================

The DBTableFilter component is a very useful component to 
allow your end user to build a filter for a dataset.
It's like the Word 6 filter: you select the field name in a combo
box, then select the comparision (equal, less than, is null, etc) in
another combo box, and then select the value. If you want to continue,
you can go to another line and select 'and' or 'or', and then select
another filed, comparision and value. The component gives the filter
to you.

------------------------------
Properties, methods and events
------------------------------
*) procedure LoadFields;
    Load all the field in the Dataset for filtering. 

*) constructor Create(AOwner : TComponent);
    Creates the component.

*) destructor Destroy; override;
    Destroys the component.

*) property FilterString : string; (public)
    Returns the Filter string to use in the Dataset's filters property.
    Example: '(CITY='LOS ANGELES') AND (AmountPaid>100)'

*) property DescString : string; (public)
    Returns a descritive string of the filter.
    Example: 'City equal Los Angeles and amount paid is greater than 100'

*) property AutoHeight : boolean;
    If this property is true, the component adjusts its height to fit 
    the lines correctly.

*) property DataSource : TDataSource;
    The DataSource which points to the dataset to be filtered.

*) property LineHeight : integer;
    The height of a line of combos. 

*) property NumLines : integer;
    The number of lines of combos. It's the total of comparision your user can do.

*) property DisableColor : TColor;
    The color of a disabled combo.

*) property FilterFields : TFilterFields; (see this class help below)
    This property contains the fields to be filtered.

And other properties and events inherited from its ancestors.

-------------------
TFilterFields class
-------------------

*) procedure Add(FName,FLabel : string);
     Add a field to be filtered. FName is the fieldname, and FLabel is the display label
     of the field. Example: Add('CustName','customer name');

*) procedure Clear;
     Clear all the fields.

*) function IndexOf(const Name: string): Integer;
     Returns the index of the field specified by Name.

*) property DBTableFilter : TDBTableFilter;
     Returns the owner of the FieldFields.

*) property Fields[Index : integer]: TFilterField; (see this class help below)
     Contains the specified fields.

------------------
TFilterField class
------------------
*) procedure Assign(Source: TFilterField);
     Copy the values of a FilterField to another.

*) property FieldName : string;
     The field name to be filtered. Ex: 'CustName'.

*) property FieldLabel : string;
     The display label of the field to be filtered. Ex: 'customer name'

----------
installing
----------

Decompress all the files in a directory. 
Choose the option Component|Install component (or Component|Install 
if you're using Delphi 2) in the Delphi menu. Click in the Browse 
button and select the DBTableFilterReg.DCU file in the Delphi3 directory,
if you're using Delphi 3, or Delphi2 directory, if you're using Delphi 2. 
The component will be installed in the L&S pallete.

---------
copyright 
---------
This component is shareware and you can use it under delphi. If you use
it out of Delphi, it will show you a message. The registered version is US$ 25.

---------
history
---------

version 1.03
------------
*) Bug fixed - Controls sometimes didn't appear when DBTableFilter was inside a panel
*) When the field is a date, the date in filter string comes inside quotas, like 
'Date = '01/01/98'', not as before: 'Date = 01/01/98'
*) if there's no FieldSpec added, the DBTableFilter loads automatically the fields to be 
filtered. If there are persistent fields, the DisplayLabel property of each field is put on
combos.
*) Demo project contains now registering information.
*) Registering with all credit cards is now available. Please see register.txt for more
information

version 1.02
------------
*) The shareware test in the source code of the registered version was removed (!);
*) The component ListBoxDialog is installed together with DBTableFilter, to avoid
conflit on installing the ListBoxDialog separatelly.

version 1.01
------------
*) The FilterFields property editor dialog is now centered in screen.

version 1.00
------------
*) First release.


-----------------------
contact and registering
-----------------------
For full information about registering the DBTableFilter component for Delphi 2/3, 
please see the register.txt file.

For contact the author, e-mail to
chipds@bbs2.sul.com.br