****************************************************************************
*                                                                          *
* CBData 0.1 - 1st November 1997                                           *
*                                                                          *
* A CodeBase 6.2 Compatible DataSet for Delphi 3.0                         *
*                                                                          *
****************************************************************************

This beta-release is FREEWARE...

1) Description
---------------
CBData contains 2 components that encapsulate the CODE4 and DATA4 CodeBase
structures: TCodeBase and TCBDataSet..

The encapsulation of DATA4 structure (TCBDataSet) is derivated from TDataSet.
That means that you can use all the Data Controls (DBGrid, DBMemo, ...)
exactly as if you were using BDE.

This beta-release was only tested with CodeBase 6.2 FoxPro DLL.

2) What do you need to use CBData
---------------------------------
2.1 The CodeBase 6.2 32bits DLL, renamed to C4FOX32.DLL
2.2 The included package collection CB62.DPC
2.3 In Delphi 3, Select Component|Install Packages... and select CB62.DPC

3) Creating a sample application
--------------------------------
3.1 Put a TCodeBase (C4) component on your form
    Give it an Alias and a DataPath
3.2 Put a TCBDataSet (D4) component on your form
    Set the Master property to the TCodeBase Alias
    Select a TableName, and eventually an IndexName
3.3 Optionally set Query and/or a Sort order.
3.4 Set the TCBDataSet Active property to True
3.5 Put a TDataSource component on your form and link it to the TCBDataSet component
3.6 Add some Data controls and test it...

4) Feedback
------------
Feedback is greatly appreciated:

by e-mail: nasdron@ibm.net

Nicolas Nasdrovisky

5) Components overview
----------------------

5.1 TCodeBase - Encapsulation of the CODE4 structure

      properties (mainly encapsulation of CODE4 fields):
      -----------
        AccessMode:           TCODE4AccessMode;
        Alias:                String;
        DataPath:             String;
        DateFormat:           String;
        ErrorCode:            Integer;
        FileFlush:            Boolean;
        LockAttempts:         Integer;
        LockAttemptsSingle:   Integer;
        LockDelay:            Integer;
        LockEnforce:          Boolean;
        Optimize:             TCODE4Optimize;
        OptimizeWrite:        TCODE4Optimize;
        ReadOnly:             Boolean;
        Safety:               Boolean;
        SingleOpen:           Boolean;
        TranStatus:           Integer;
        UnlockAuto:           TCODE4UnlockAuto;

      methods (mainly encapsulation of CODE4 functions):
      --------
        Close:                Integer;
        ClearError;
        Create(AOwner: TComponent);
        Destroy;
        Flush:                Integer;
        Lock:                 Integer;
        LockClear;
        TranCommit:           Integer;
        TranRollBack:         Integer;
        TranStart:            Integer;
        Unlock:               Integer;

5.2 TCBDataSet - Encapsulation of the DATA4 structure

      properties:
      -----------
        Active:                Boolean;
        Handle:                DATA4;
        IndexName:             String;
        Master:                String;
        Query:                 String;
        Sort:                  String;
        TableName:             String;
        ToggleDelete:          Boolean;

	  + inherited TDataSet properties (Active, BOF, EOF, RecordCount, State, ...)

      events:
      -------
        BeforeOpen;
        AfterOpen;
        BeforeClose;
        AfterClose;
        BeforeInsert;
        AfterInsert;
        BeforeEdit;
        AfterEdit;
        BeforePost;
        AfterPost;
        BeforeCancel;
        AfterCancel;
        BeforeDelete;
        AfterDelete;
        BeforeScroll;
        AfterScroll;
        OnCalcFields;

      methods (mainly encapsulation of DATA4 functions):
      --------
        Create(AOwner: TComponent);
        Destroy;
        Deleted:                       Boolean;
        Flush;
        GetTags:                       TStringList;
        GetTables:                     TStringList;
        IsSequenced:                   Boolean;
        Lock;
        Pack;
        Recall;
        Seek(Key: String):             Boolean;
        SeekNext(Key: String):         Boolean;
        SeekDouble(Key: Double):       Boolean;
        SeekNextDouble(Key: Double):   Boolean;
        Unlock;
        Zap;

        + inherited TDataSet methods (Open, Close, First, Last, Next, FieldByName, ...)