                           FreeReport 2.32
                 для Delphi 2/3/4/5 и C++Builder 5


                ВНИМАТЕЛЬНО ПРОЧИТАЙТЕ ЭТОТ ФАЙЛ ПЕРЕД
                УСТАНОВКОЙ КОМПОНЕНТА И НАЧАЛОМ РАБОТЫ!

ВНИМАНИЕ:
  Если вы обновляете FreeReport с версий >= 2.21.7 прочтите раздел
"4. Совместимость с предыдущими версиями" прежде чем устанавливать
библиотеку.

----------------------------------------------------------------------------
СОДЕРЖАНИЕ

1. Введение
2. Возможности
3. Установка
4. Совместимость с предыдущими версиями
5. Лицензия
6. Примечания


----------------------------------------------------------------------------
1. ВВЕДЕНИЕ.

   FreeReport - это компонент для построения отчетов, представляет собой
сочетание дизайнера, генератора и Preview отчетов в одном флаконе. По
возможностям примерно соответствует QuickReport 3, ReportBuilder 3.52.
   FR является условно-бесплатным (shareware) продуктом. Ограничения и
условия приобретения см. в п.5.
   Автор не гарантирует правильную работу компонента и не несет ответствен-
ности за возможный ущерб в результате использования данного программного
обеспечения. Все замечания и пожелания отправляйте по нижеприведенному адресу.


----------------------------------------------------------------------------
2. ВОЗМОЖНОСТИ.

- Бэнд-ориентированный генератор отчетов.
- Встроенный мощный дизайнер, доступный и в run-time.
- Preview как в MS Word.
- Скорость работы сравнима с QuickReport1.
- Компактность кода - без дизайнера меньше QR1.
- Неограниченное количество страниц сформированного отчета.
- Многостраничные отчеты; составные (композитные) отчеты; вложенные отчеты;
  группы; многоколоночные отчеты; master-detail-detail отчеты;
  cross-tab отчеты; двухпроходные отчеты.
- Полный контроль над процессом печати, поддержка всех типов бумаги.
- Набор наиболее популярных компонентов: Текст, Линия, Рисунок, Фигура,
  OLE объект, RichText, RX Rich 2.0, Диаграмма, Штрих-код.
- Экспорт в TXT, RTF, CSV, HTML.
- Поиск текста в сформированном отчете.
- Add-in компонент TfrDataStorage, предназначенный для создания запросов и
  таблиц в run-time - специально для т.н. enduser-отчетов (по функциональ-
  ности соответствует QRDesigner). Поддерживает Interbase Express (IBX),
  ActiveX Data Objects (ADO) без использования BDE.
- Редактирование сформированного отчета.
- Встроенный интерпретатор Pascal-подобного языка для управления процессом
  построения отчета.
- Форма отчета может храниться как в DFM, так и во внешнем файле.
- Функциональность может быть расширена за счет написания собственных
  компонент - визуальных объектов, мастеров, библиотек функций.
- Работа как с Database - ориентированными источниками данных, так и с
  любыми данными.
- Файлы справки: справка по компоненту и справка по среде FR, распространя-
  емая с конечным приложением.


----------------------------------------------------------------------------
3. УСТАНОВКА.

   Установка включает в себя два этапа: установка библиотеки компонент и
подключение файла справки к справочной системе Delphi.
   FreeReport содержит несколько наборов языковых ресурсов: на русском,
украинском, английском, немецком, французском, итальянском, испанском
языках. Ресурсы находятся в каталоге ..\FR\RES. По умолчанию библиотека
компонент устанавливается с английскими ресурсами. Чтобы использовать русские
ресурсы, скопируйте файлы с расширением RES из каталога ..\FR\RES\RUSSIAN в
каталог ..\FR\SOURCE.
   FreeReport поставляется в исходных текстах. В ограниченной версии есть
только один скомпилированный модуль - FR_Class.dcu. Версии этого модуля
для Delphi 2/3/4/5 содержатся в каталогах LIB_D2...LIB_D5. Перед
установкой компонента скопируйте нужную версию модуля в каталог ..\FR\SOURCE.
   FreeReport поставляется с двумя файлами справки: справка по компонентам
FR, встраиваемая в Delphi (файл FR.hlp), и справка по среде FR (FRUser.hlp),
которая доступна из любого места FR как при работе в Delphi, так и в готовом
приложении. Эту справку можно вызвать из дизайнера (пункт меню
"?/Вызов справки") либо из любого диалога, нажав кнопку с вопросительным
знаком в заголовке окна и затем выбрав интересующий элемент управления.
Если окно не содержит такой кнопки, ищите ее на панели инструментов окна.

3.1. Delphi 5.0.
   Выберите пункт меню "File/Open...", и откройте пакет (package)
Freerep5.dpk из каталога ..\FR\SOURCE. В появившемся окне "Package - ..."
нажмите кнопку "Compile". После компиляции пакета нажмите кнопку "Install".
С помощью команды меню "Tools/Environment options..." откройте диалог
с настройками среды и на закладке "Library" добавьте путь к каталогу
..\FR\SOURCE в строке редактирования "Library path".
   Для подключения к справочной системе Delphi файла помощи необходимо:
- скопировать файлы из каталога ..\FR\Help в каталог ..\Delphi5\Help;
- в файле ..\Delphi5\Help\Delphi5.cnt добавить нижеприведенные строки:
:Index FastReport Reference=FR.hlp
:Link FR.hlp

3.2. C++Builder 5.0
   Выберите пункт меню "File/Open...", и откройте пакет (package)
FreeRep5.bpk из каталога ..\FR\SOURCE. В появившемся окне "Package - ..."
нажмите кнопку "Compile". После компиляции пакета нажмите кнопку "Install".
ПОСЛЕ УСТАНОВКИ ОБЯЗАТЕЛЬНО ПЕРЕГРУЗИТЕ C++BUILDER!
   Для подключения к справочной системе C++Builder'а файла помощи необходимо
воспользоваться пунктом меню "Help/Customize..." после чего в появившемся
окне "OpenHelp - ..." на вкладке "Contents" добавить файл ..\FR\FR.cnt, на
вкладке "Index" - файл ..\FR\FR.hlp. После чего сохранить проект (File/Save
Project).

3.3. Delphi 4.0.
   Выберите пункт меню "File/Open...", и откройте пакет (package)
FreeRep4.dpk из каталога ..\FR\SOURCE. В появившемся окне "Package - ..."
нажмите кнопку "Compile". После компиляции пакета нажмите кнопку "Install".
С помощью команды меню "Tools/Environment options..." откройте диалог
с настройками среды и на закладке "Library" добавьте путь к каталогу
..\FR\SOURCE в строке редактирования "Library path".
   Для подключения к справочной системе Delphi файла помощи необходимо:
- скопировать файлы из каталога ..\FR\Help в каталог ..\Delphi4\Help;
- в файле ..\Delphi4\Help\Delphi4.cnt добавить нижеприведенные строки:
:Index FastReport Reference=FR.hlp
:Link FR.hlp


3.4. Delphi 3.0.
   Выберите пункт меню "File/Open...", и откройте пакет (package)
FreeRep3.dpk из каталога ..\FR\SOURCE. В появившемся окне "Package - ..."
нажмите кнопку "Compile". После компиляции пакета нажмите кнопку "Install".
С помощью команды меню "Tools/Environment options..." откройте диалог
с настройками среды и на закладке "Library" добавьте путь к каталогу
..\FR\SOURCE в строке редактирования "Library path".
   Для подключения к справочной системе Delphi файла помощи необходимо:
- скопировать файлы из каталога ..\FR\Help в каталог ..\Delphi3\Help;
- в файле ..\Delphi3\Help\Delphi3.cnt добавить нижеприведенные строки:
:Index FastReport Reference=FR.hlp
:Link FR.hlp

3.5. Delphi 2.0.
   Выберите пункт меню "Component/Install...", в появившемся диалоге нажмите
кнопку Add и выберите модуль FR_Reg.pas из каталога ..\FR\SOURCE. После этого
нажмите кнопку OK. После перекомпиляции библиотеки в палитре компонентов
появятся новые закладки FastReport и FR Tools.
   Для подключения к справочной системе Delphi файла помощи необходимо:
- скопировать файлы из каталога ..\FR\Help в каталог ..\Delphi2\Help;
- сохранить резервную копию файла ..\Delphi2\BIN\Delphi.hdx;
- запустить приложение ..\Delphi2\HELP\TOOLS\HelpInst.exe;
- открыть в нем файл ..\Delphi2\BIN\Delphi.hdx и выбрать в меню
  "Keywords/Add Keyword File";
- открыть файл FR.kwf, расположенный в каталоге ..\Delphi2\HELP;
- выбрать "File/Save";
- в файле ..\Delphi2\Help\Delphi.cnt добавить нижеприведенные строки:
:Index FastReport Reference=FR.hlp
:Link FR.hlp

   Следует отметить, что из-за глюка в Delphi2 VCL справка по диалоговым
окнам дизайнера не работает в design-time. Файл справки доступен только с
помощью пункта меню дизайнера "?/Вызов справки". В скомпилированном прило-
жении все работает правильно.

----------------------------------------------------------------------------
4. СОВМЕСТИМОСТЬ С ПРЕДЫДУЩИМИ ВЕРСИЯМИ.
   Версии  совместимы по формату файлов .frf сверху вниз. Обратная совмести-
мость не поддерживается.
   В версии 2.3 поменялся формат файлов .frp (файл с построенным отчетом).
Теперь этот файл хранит форму отчета в виде "живых" объектов. Это сократило
размер примерно в три раза, кроме того, позволило редактировать сохраненный
отчет и делать экспорт. Файлы frp старых версий поддерживаются, но из них
нельзя делать экспорт.
   Версии 2.1, 2.2 и 2.3 полностью совместимы. Единственное, что придется
исправить при переходе на версию 2.3 - атрибуты выделения.

  Файлы отчетов, созданные в FreeReport версий >= 2.21.7 несовместимы по 
формату с текущим форматом и Вам необходимо конвертировать ваши отчеты
до текущей версии. 

  Что бы сконвертировать отчеты проделайте следущее:
 
   (a) Раскоментируйте строку 58 в файле fr.inc {$DEFINE FREEREP2217READ} 
       что бы включить поддержку чтения отчетов FreeReport
   (b) Установите пакет как описано в разделе 3 данного документа.
   (c) Отройте и скомпилируйте файл проекта CnvReps.dpr расположенный в 
       папке DEMOS\CNVREPS\
   (d) Используя созданное приложение CnvReps.exe сконвертируйте ваши отчеты.
   (e) Востановите коментарии в строке 58 файла fr.inc  {$DEFINE FREEREP2217READ}
       что бы отключить поддержку чтения отчетов FreeReport
   (f) Выберите пункт меню "Components" -> "Install Packages"
   (g) Выберите в списке "FreeReports 2.32 Components" и нажмите кнопку "Edit"
       для открытия FREEREPx.DPK
   (h) В открывшемся окне редактора пакетов нажмите кнопку "Compile" что бы 
       перекомпилировать пакет

----------------------------------------------------------------------------
5. Лиценизия.
Данная версия FreeReport основана на FastReport ver. 2.32 и 
выпущенна автором для свободного использования на условиях
LGPL. Перед использованием данной библиотеке внимательно ознакомьтесь
с текстом лицензии, находящемся в файле license-rus.txt 
(или в license.txt английском языке)


----------------------------------------------------------------------------
6. ПРИМЕЧАНИЯ.
   Все модули написаны собственноручно, за исключением:
- Редактор объекта RichEdit взят из \DEMOS\RICHEDIT
- Определение версии Delphi и Windows взято из исходников RX 2.60.
- Компонент TfrSpeedButton основан на RX TrxSpeedButton.
- Компонент Barcode (Barcode.pas) написан Andreas Schmidt and friends
  (freeware) и адаптирован под FastReport Olivier Guilbaud. Подробности
  см. в файле Barcode.pas.
- Компонент RoundRect (FR_RRect.pas) написан Olivier Guilbaud. Подробности
  см. в файле FR_RRect.pas.

   Также переписан позаимствованный код:
- Меню с картинками ранее базировалось на исходниках D4 menus.pas,
  сейчас переписано.
- Управление принтером (FR_Prntr.pas) ранее базировалось на исходниках QR1,
  сейчас переписано.

   Картинки на кнопки и на компоненты - MS Word, ReportBuilder, QuickReport,
Delphi\Images.
   Идеология - ReportBuilder, QuickReport, 1C-Бухгалтерия 6.0.


----------------------------------------------------------------------------
Автор: Цыганенко Александр

Контактная информация:

E-mail: freereport@mail.ru
   WWW: freereport.sf.net