===================================================
DBTableFilter component - 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 in the
Delphi menu. Click in the Browse button and select the 
DBTableFilterReg.DCU file in the directory. The component will be
installed in the Dialogs 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$ 10, and the full source code is US$ 25.

You can request a registered version and the source code by e-mail:

chipds@bbs2.sul.com.br

Visit my little Delphi page at:
bbs2.sul.com.br/chipds/delphi