Ek RTF Report for Delphi
Version 1.50 build 2 (D4, D5)


CONTENTS
1. Component description
2. History
3. License
4. Installation
5. Troubleshooting.
6. Contact information

1. COMPONENT DESCRIPTION
TEkRtf report is non visual component that allows you to use all power of MS Word or other rtf-compatible editor
to create, preview, edit and print your reports.

How to use it:
- create report template in MS Word
- save it in RTF format
- place TEkRTF component on form, fill required properties
- prepare data in your application
- run report using one of Execute methods
- run MS Word (or other editor) if you want to view, edit or print your document

For more information see help and demo application.
go top


2. HISTORY

Version 1.50
"noeof" option in "Scan" keyword \Scan(DataSet)[,page][,noeof]\ - scan block will be missed on eof of scanned dataset
new keyword \ScanEntry\
extended syntax for fields with spaces in names
optimized core of report engine
#11 will appear as "line break" control in output file,
#12 will appear as "new page" control in output file

Version 1.48
property ExecuteSuccessful (true if no errors)
property LastErrMsg (contains last error message if Execute report fails)
fixed bug with omitted exceptions
added additional checking to ExecuteOpen method

Version 1.47
"page" option in keyword \Scan(DataSet)[,page]\. Forces to begin new record of scanned DataSet with new page.
New extended syntax for field names: \DataSet:(NNN)\ , NNN is field number in DataSet.

Version 1.45
ExecuteStream method.
New format function flnk() - hyperlink format
ExecuteOpen works from console applications.

Version 1.42
Methods: SetTemplateBuffer, FreeTemplate.
go top


3. LICENSE

TEkRTF COMPONENT IS DISTRIBUTED "AS IS". NO WARRANTY OF ANY KIND IS EXPRESSED OR
IMPLIED. THE AUTHOR WILL NOT BE LIABLE FOR DATA LOSS, DAMAGES OR ANY OTHER KIND
OF LOSS WHILE USING THIS SOFTWARE. THIS PRODUCT IS FREE FOR NON-COMMERCIAL USING
AND EVALUATING. YOU MUST REGISTER YOUR COPY OF EK RTF IF YOU USE IT IN COMMERCIAL
PROJECTS.

Registered users will receive source code and updates applicable for current version.
To register this product goto http://gpb.skiftel.ru/ec/ then press "Register" button, or you may go to
directly to registration page
go top


4. INSTALLATION IN DELPHI 4 AND DELPHI 5

1. Uninstall previous version of EkRTF:
Select "Component/Install Packages" from the Delphi IDE. Select the package file EComp.bpl,
click "Remove" button, click "OK". Select the package file Edsn.bpl, click "Remove" button, click "OK".
2. Select "Component/Install Packages" from the Delphi IDE.
3. Click on the "Add" button and select the package file EComp.bpl in the directory were it unzipped.
Click "Open" to install the package.
4. Install package Edsn.bpl the same way as Ecomp.bpl
5. Select "Tools/Environment Options" from the Delphi IDE.
6. Select the "Library" tab.
7. Check the path to EComp pakage in "Library Path" edit box. It must reference to location where is the
new version of EkRTF component. Installed component will appear in "Data Access" panel.

HELP INSTALLATION:

The following steps describe how to manually install TEkRTF report Help file.
1. Copy the files EkRtf.hlp and EkRtf.cnt into the HELP directory in Delphi main directory. Delete files EkRTF.gid from old versions of help.
2. Add the line (if it does not exists)

:Index TEkRTF report component=EkRtf.hlp

to the "Index" section at the top of the DELPHI5.CNT (DELPHI4.CNT) file located in the Delphi HELP directory. If you can't find "Index" section in file DELPHI5.CNT (DELPHI4.CNT), then just add string
:Index TEkRTF report component=EkRtf.hlp
after string
:Title Delphi Help

Delete file Delphi5.gid (Delphi4.gid) in Delphi help directory, to initiate help index rebuild on next help request in Delphi.
go top


5. TROUBLESHOUTING

Before running demo projects, check that you have application associated with doc and rtf files.
Otherwise output files will be saved on disk, but will not open automatically.
Delete all pathes from menu Tools\Enviroment options\Library\Directories\ which references to
old versions of component. If compiled programm cannot find input rtf file and generates exception place
your compiled exe file into project source directory (directory with source rtf files) or type full path and file
name in property "InputFile".
go top


6. CONTACT INFORMATION

if you have any questions, comments or suggestions email to ec@gpb.skiftel.ru
See the latest version of Ek RTF Report on component home page at http://gpb.skiftel.ru/ec/

go top