EK RTF - readme

EK RTF report are non visual components which allow to use all power of MS Word or other rtf-compatible editor to create, preview, edit and print your reports.

How to make it working:

Design time:
• create report template in any text processor
• save it in RTF format
• place EkRtf component on a form
• set InFile (input rtf template) property

Run time:
• prepare data in your application, create variables if necessary
• run report using one of Execute or ExecuteOpen methods
• run MS Word (or other editor) if you want to view, edit or print your document

See more details in documentation "creating report template" section.

Version 4.03
• Frtf() function improved with new rtf tags;
• Fixed bug in ROUND function when number of 0.005 could be wrongly handled;
• FileOpen mode is changed for InFile to ShareDenyNone;
• Fixed functions frtf() and fbool();
• Fixed method SetTemplateBuffer;
• Functions CurrencyString, CurrencyFormat, NegCurrFormat, ThousandSeparator, DecimalSeparator, CurrencyDecimals are sensitive to Windows Regional Settings.

Version 4.00 for .Net is based on a source code of components version 3.08 for Win32. Components code is completely rewritten in order to use pure .Net calls wherever it is possible.

What is changed since Win32 version:
1) Binding data with report. New property ReportData is used to attach data to the report template ;
2) Report variable methods AsDate AsDateTime work with .Net System.DateTime type instead of Delphi's TDateTime;
3) All images in this version are inserted as hexadecimal code instead of binary. Scale of image is computed basing on real image size and resolution. It may not coincide with the scale that Word shows in image properties;
4) No variables available at design time;
5) EkUDF class - property FunctionName is now used instead of Name for user defined functions;
6) User functions with udfrImage result type expects that new UDFResult object will be created in function code;
7) Fdtm() format function works with .Net "Custom DateTime Format Strings" instead of Borland format strings;
8) New designer for user defined function;
9) New documentation available in chm and Help2 formats.

go top

3. LICENSE
PLEASE READ THIS SOFTWARE LICENSE AGREEMENT CAREFULLY BEFORE USING THE SOFTWARE. BY CLICKING ON THE "ACCEPT" BUTTON, OPENING THE PACKAGE, OR USING THE EQUIPMENT THAT CONTAINS THIS PRODUCT, YOU ARE CONSENTING TO BE BOUND BY THIS AGREEMENT.

This license agreement covers your use of the EK RTF report components, its source code, documentation, dcu, bpl, dll and other files, hereinafter referred to as "SOFTWARE". You may use it and distribute it according to this following License Agreement. If you do not agree with these terms, please remove the SOFTWARE from your system.

SOFTWARE 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 ONLY FOR EVALUATION USING.
YOU MUST REGISTER YOUR COPY OF THE SOFTWARE IF YOU USE IT IN REAL PROJECTS. THE EVALUATION VERSION OF SOFTWARE FILLS THE "AUTHOR" AND "COMMENTS" PROPERTIES OF OUTPUT DOCUMENT WITH INFORMATION ABOUT THIS PRODUCT. EVALUATION VERSION MAY ALSO HAVE SOME LIMITATION, DESCRIBED IN DOCUMENTATION OR README FILES.

The unregistered evaluation version of the SOFTWARE may be freely distributed, provided the distribution package is not modified.

You may Install and use the SOFTWARE for the purposes of designing, developing, testing, and deploying application programs which you create. However,your programs must add primary and substantial functionality, and may not be merely a set or subset of any of the libraries, code, packages or other files of the SOFTWARE;

You may not create a components, library or standalone executable application (whether it be freeware, shareware or a commercial product) which directly or indirectly competes with the SOFTWARE.

The registered SOFTWARE may not be rented or leased, but may be permanently transferred, if the person receiving it agrees to terms of this license. If the SOFTWARE is an update, the transfer must include the update and all previous versions.

Any part of the source code may be changed by author of the SOFTWARE in future versions. These changes may include the removal of classes, properties and methods or the creation of new classes, properties and methods.

This license is subject to change without notice in future updates to the SOFTWARE.
go top

4. INSTALLATION

COMPONENTS INSTALLATION:

• In Visual Studio 2005 IDE open Tools\Choose Toolbox Items, .Net Framework Components tab
• Press button "Browse"
• Choose EkRtf_VS.dll in it's location
• In the component list EkRtf and EkUDFList classes will appear
• Press OK

HELP INSTALLATION:

Directory Help2 contains EK RTF documentation, which may be integrated with VS2005 help system. To install this help make the following steps:
• Close Visual Studio IDE
• Execute setup.exe
• Next time you open VS IDE, window "Help is updating..." will appear. Help is installed.

go top

5. REGISTRATION

To register this product you may go to http://ekrtf.code.net.ru/reg.html
go top

6. 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.
go top

7. CONTACT INFORMATION

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