TDBGridPro component 1.0.x.x		   (c) Copyright by Sergey P.Suturin
============================		   WWW: http://www.gin.ru/vipper
					   e-mail: vipper@gin.ru


			TABLE OF CONTENTS
			----------------------
			Introduction
			Installation
			Help installation
			Component registration in Borland Delphi IDE
			Component using recommendations
			Troubleshooting
			In the future...
			Component registration
			Technical support and feedback

Introduction
------------
TDBGridPro is VCL component, which performs data visualization and editing in
two-dimensional grid. 

The TDBGridPro version 1.0 is distributed as freeware. TDBGridPro registration
is free too. You can distribute TDBGridPro as long as you do not make any
changes to the orignial zip file.

For latest version of the component, online documentation (PDF) and examples
visit our WEB site.

Before component using you have to conclude the license agreement with the
author. The text of this agreement is placed in 'license.txt' file. You should
accept the license agreement because you may not use component without license
agreement acceptance in whole.

 
Installation
------------
Having unpacked supplied archive you will have got following folders created:
...\BIN	contains *.DCU , *.DFM , *.RES & *.INC files.
...\HELP	contains *.HLP & [*.CNT or *.KFW] files.
...\DEMO	contains sample applications.
--
All files from  ...\BIN folder are recommended to be moved to new folder,
from which you will install component to Borland Delphi. Files from ...\HELP 
folder must be moved to ...\HELP subfolder, where you've installed Borland 
Delphi (for example for Delphi 2.0 it is 
"c:\Program Files\Borland\Delphi2.0\Help").

Help installation
-----------------
	Delphi 2.0:
	----------
	* launch "helpinst.exe" application in ...\Help\Tools subfolder.
	* Choose File | Open from menu. In this dialog choose ...\Bin path 
	  and double-click on DELPHI.HDX file.
        * Choose Keywords|Add Keyword File... from menu and click on *.KFW
	  file, which was told in "Installation".
	* Choose File | Save from menu. After some time you can close 
	  "helpinst.exe". If you've done everything correctly, you'll have
 	  TDBGridPro help installed.


	Delphi 3.0:
	----------
	* In ...\Help subfolder open "delphi3.cfg" file.
	* In last lines of that file find string containing "; Third-party
	  Help" (after that line you'll see some lines like this: ":Link 
	  quickrpt.hlp"). Add new string to that file, ":Link *.HLP", but 
	  change '*' symbol on file name which was told in "Installation".
	* Save changes in "delphi3.cfg" file.


	Delphi 4.0:
	----------
	* All as described previously except file for editing. Now they 
	  called it "delphi4.cfg".

	---------------------------
	* Note: in all three cases ...\<folder name> means that folder is
	  situated at the path where you've installed Borland Delphi.
	* Advise: if help system doesn't work correctly please try to delete
	  all *.GID files from ...\Help subfolder of Delphi. These files will
	  be created again when you call Delphi help.
	* Recommendation: please call us for technical support in the case of
	  malfunctioning and troubleshooting.


Component registration in Borland Delphi IDE
--------------------------------------------
	Install this component as usual. You should register DBGridPro.dcu
	unit only. Delphi 3.0 users (and higher ersions) can put TDBGridPro
	component in any Package they like or create new one and compile it
	than. Component will be added to DataControls page. To get help on
	how to create new packages see Dephi's help.


Component using recommendations
-------------------------------
* Having read this file please examine component help. This will really HELP
  you to avoid many troubles in component using.

* First and NECESARY step is, when you've put component on the form, to 
  create default columns (see section property editor: "Creating default 
  columns").

Troubleshooting
---------------
1. Sometimes, AFTER default columns creation in design mode, DRAW EXCEPTION can
   occure. Don't worry, this will NOT cause any data loosing. So, click right
   mouse button and choose VIEW AS TEXT from popup menu. Having seen your form as
   text right-click mouse again and choose VIEW AS FORM. It will return you to
   previous editing mode. DRAW EXCEPTION will not raise again. This exception can
   occure only at design-time mode.
2. Warning! There are some limitations on DataLink parameter using, which is
   passed to OnDrawSection event. Please examine our example project,
   OnDrawSection event source code, supplied with component.
3. When Options.dgMultiSelect is true, lines in the grid won't be colored.
   But respective pictures will be drawn in the indicator area.
4. When setting Design.FixedColumn property and trying to change columns
   properties, selected column will be changed on first one. So we recommend
   you to set Design.FixedColumn flag at the last step of section design.
5. If you set Options.dgTitles property and there are less than two records
   in a grid, height of the title will be incorrect. This is only in the case
   when Design.TitleHeight = -1.
   Note: this problem appears when your application try to change this pro-
         perty, BUT sometimes raises in Delphi IDE too.
   Solution: if your application needs to change dgTitles property and you
	     are not sure that there are more than one record in a grid, it
	     is NECESSARY to refresh data in the DataSet using following code:
		    ...
		 DataSet.Active := false;
            	 DataSet.Active := true;
		    ...
6. TDBGridPro ingnores (only now) dgRowLines and dgColLines parameters, it 
   just clears them to draw more nicely indicator (TCustomDBGrid.DrawCell 
   method draws it).

In the future...
----------------
(it is recommended to view functional possibilities of this component before
reading this chapter).
------------
1. Our highest priority task is the developing of data editing system and 
   increasing maximum number of sections in a column.
2. New property will be added to Design group - separator color.
3. TColumnSection will be changed in the next way:
   LoadFromFile and SaveToFile methods will be added. Using this methods will
   allow compatibility among different versions of the component.

many interesting features will be added also, stay with us ...


Component registration
----------------------
All information about registration is available in WWW: http://www.gin.ru/vipper
Having registered (free-of-charge !) you'll get your personal registration
number. This number will guaranty you technical support via e-mail in 24 hours.


Technical support and feedback
------------------------------
We will be glad to get for any questions, wishes and critical words. We will
evince respect for any letter sent to us. Please visit our WebSite where you
can find all necessary e-mail adresses.
