EhLib
User's guide
|
EhLib |
User's guide |
|
| Installation |
Below it will be described how to install EhLib under Delphi 6.
Uninstall previous or evaluation
version of EhLib from Delphi 6 IDE.
Remove or copy to other directory this files to prevent crossing this and new
version of EhLib (Including EhLib.bpl, EhLib.dcp or
EhLibXX.bpl, EhLibXX.dcp files).
| Unpacking archive |
Unpack EhLib archive.
After unpacking you have to get next directories:
Directories of 'EhLib - source include' version:
| BCB4 | Contain source files which are specific for C++ Builder 4. |
| BCB5 | Contain source files which are specific for C++ Builder 5. |
| BCB6 | Contain source files which are specific for C++ Builder 6. |
| Common | Contain source files which are common for all versions of Delphi and C++ Builder. |
| Delphi4 | Contain source files which are specific for Delphi 4. |
| Delphi5 | Contain source files which are specific for Delphi 5. |
| Delphi6 | Contain source files which are specific for Delphi 6. |
| Delphi7 | Contain source files which are specific for Delphi 7. |
| DEMOS | Demonstration projects. It use tables from the DEMOS directory and BDE alias "DBDEMOS". |
| LangResources | Contain resource files for various languages. |
| DataService | Contain files that contain objects that allows to sort data in various types of datasets. |
| ORDERS | Contain text files in which described how to register various versions of EhLib. |
| HLP | Contain help files. |
Directories of 'Ehlib - without source' version or 'Ehlib- Evaluation version':
| BCB4 | Contain all binary files which are need for C++ Builder 4. |
| BCB5 | Contain all binary files which are need for C++ Builder 5. |
| BCB6 | Contain all binary files which are need for C++ Builder 6. |
| Common | Contain interface part of source files of EhLib. (Only for information, not require for installation.) |
| Delphi4 | Contain all binary files which are need for Delphi 4. |
| Delphi5 | Contain all binary files which are need for Delphi 5. |
| Delphi6 | Contain all binary files which are need for Delphi 6. |
| Delphi7 | Contain all binary files which are need for Delphi 7. |
| DEMOS | Demonstration projects. It use tables from the DEMOS directory and BDE alias "DBDEMOS". |
| LangResources | Contain resource files for various languages. |
| DataService | Contain files that contain objects that allows to sort data in various types of datasets. |
| ORDERS | Contain text files in which described how to register various versions of EhLib. |
| HLP | Contain help files. |
Create, if need, new directory "EhLib" in your Delphi 6 directory. (For instance: C:\Delphi6\EhLib).
If you have EhLib - source
include version then copy in this directory files from Common and Delphi6 directory
of EhLib archive.
If you have EhLib - without source version or evaluation version EhLib then
copy in this directory files from Delphi6 directory of EhLib archive.
By
default EhLib contain resource for English language. If you need other language
you can replace original resource files (which already present in C:\Delphi6\EhLib)
by the files that is placed in corresponding language directory.
If you does not found directory for necessary language then you need to
take files for any existing language directory and change it as you need.
| Installing packages. |
Run Delphi and use "File\Open..." menu item of Delphi IDE to open the EhLib runtime package C:\Delphi6\EhLib\EhLib60.dpk. In "Package..." window click "Compile" button to compile and build bpl file.
By default Delphi place compiled EhLib60.BPL file to the <Delphi path>\Projects\Bpl directory and this directory already present in the search PATH. But if you overwrite default BPL directory then you need put compiled EhLib60.BPL file into directory that is accessible through the search PATH (i.e. DOS "PATH" environment variable; for example, in the Windows\System directory).
After compiling run-time package you must install design-time package DclEhLib60.BPL into the IDE.
Use "File\Open..." menu item to open design-time package DclEhLib60.dpk. In "Package..." window click "Compile" button to compile the package and then click "Install" button to register EhLib components on the component palette.
EhLib components have to appear on 'EhLib' page of components palette.
Instalation note for users who had EhLib 1.X or 2.X:
Note that Delphi IDE does not move components to the new default place on components
palette when you install new version of same component(s). So if you already
has EhLib installed, then installation new (3.0) version does not move
EhLib components to the 'EhLib' page. To force Delphi IDE to move compontes
to the default place on components palette do next:
Open menu: Component->Configure Palette.
Select '[All]' line in Pages listbox.
Click 'Default Pages' button.
Add,
(if need) EhLib directory ("C:\Delphi6\EhLib") in Tools->Environment
Options->Library-> Library Path.
| Problem: | Solution: |
| In compilation time Delphi give up next error: "Unit AAA compiled with different version of unit BBB" | 1.
It can be because Delphi have access to units from old version of EhLib.
Try to remove old version of EhLib completely.
2. It can be because your Delphi or C++ Builder Build number
is not equal of Delphi or C++ Builder Build number under which
EhLib was compiled. See Build number of Delphi and C++ Builder
under which EhLib was compiled below: |
| [Fatal Error] EhLib.dpk(51): File not found: 'DBSumLst.dcu' | It
can be because you did not copy files from Common and Delphi6 directories
of EhLib archive to the one directory. If you have EhLib - source include version then copy files from Common and Delphi6 directory of EhLib archive to alone directory. |
| Installing help. |
Copy
EhLib.hlp and EhLib.cnt files from HLP directory of EhLib archive to the Delphi
6 HELP subdirectory.
Run Delphi IDE.
Select Help|Customize menu to start the OpenHelp application.
Add the EhLib.cnt file to the Contents page, add the EhLib.hlp file to the Index
and Link pages.
Select "File->Save Project" menu.
Close OpenHelp application.
To check that EhLib help files have been installed correctly, drop DBGridEh
component on the form and press F1. Delphi IDE have to open help window with
information about TDBGridEh component.
If
you want to install help files under several Delphi versions simultaneously
(or under C++ Builder and Delphi simultaneously) then you have to create a copy
of EhLib.hlp and EhLib.cnt for every version of Delphi or C++ Builder with individual
files name (For instance for Delphi 6 copy files EhLib.hlp andEhLib.cnt to EhLibD6.hlp
and EhLibD6.cnt respectively).
Next - need to edit file EhLibD6.cnt. It file contain several ":Include"
clause at first lines. Comment (using semicolon sign) lines that not contain
DELPHI6.OHL word)
:BASE EhLib.hlp
:TITLE EhLib library
;:Include bcb4.cfg
;:Include bcb5.ohl
;:Include delphi4.cfg
;:Include DELPHI5.OHL
:Include DELPHI6.OHL.
Copy
EhLibD6.hlp and EhLibD6.cnt to Delphi 6 HELP subdirectory and install help files
as described above.
| |
EhLib
Team |
|