Компоненты Rave Reports в VCL

Для взаимодействия с приложениями, создаваемыми в Delphi, вместе с Rave Reports поставляется набор VCL-компонент. В Delphi 7 и более поздних версиях они установлены по умолчанию и находятся на вкладке Rave палитры компонентов Delphi.

Все компоненты Rave можно условно разделить на 4 категории - для управления проектом, для организации соединений с данными, для вывода на печать или на экран, а так же для экспорта в какой-либо формат. Всего же их насчитывается 13:

· RvProject - ключевой компонент, используемый для взаимодействия между отчетом Rave и приложением Delphi;

· RvSystem - компонент, обеспечивающий взаимодействие между отчетом и функциями по печати и просмотру отчета. Фактически, RvSystem является интегрированной версией RvNDRWriter, RvRenderPreview и RvRenderPrinter;

· RvCustomConnection - обеспечивает соединение с источником данных типа текстового файла, таблицы Excel и т.п.;

· RvDataSetConnection - обеспечивает соединение с набором данных СУБД;

· RvTableConnection - обеспечивает соединение с компонентом типа Table;

· RvQueryConnection - обеспечивает соединение с компонентом типа Query;

· RvNDRWriter - компонент для подготовки отчета в специальном двоичном формате для дальнейшего вывода на принтер или для просмотра на экране;

· RvRenderPreview - компонент, обеспечивающий вывод отчета на экран;

· RvRenderPrinter - компонент, обеспечивающий вывод отчета на печать;

· RvRenderPDF, RvRenderHTML, RvRenderRTF, RvRenderText - группа компонентов, обеспечивающих экспорт отчета в форматы PDF, HTML, RTF или в текстовый файл.

Наиболее важным для построения отчета компонентом, безусловно, является компонент RvProject, поскольку без его участия невозможно взаимодействие приложения с отчетами Rave Reports. Связь с проектом отчета осуществляется при помощи свойства Project File, которому присваивается имя RAV-файла с проектом отчета:

RvProject1.ProjectFile:='c:\project1.rav';

Поскольку в одном проекте Rave Reports может находиться несколько отчетов, то для выбора нужного отчета используется свойства ReportName, ReportFillName и ReportDesc, позволяющие сослаться на нужный отчет по его короткому или полному имени, или по описанию. Чтобы получить список всех отчетов проекта, можно прибегнуть к процедуре GetReportList, которая возвращает список всех отчетов проекта. При этом в качестве первого параметра, передаваемого этой процедуре, должен быть передан объект типа TStrings, а в качестве второго - булево значение, в зависимости от которого список будет заполнен либо сокращенными, либо полными названиями отчетов.

С другими компонентами Rave, используемыми для управления отчетом, компонент RvProject связывается при помощи свойства Engine. В типичном случае, в качестве Engine указывают компонент RvSystem, при помощи которого можно выводить отчет как на экран, так и на печать, или же экспортировать его в файл. Фактически, работа с отчетом Rave Reports в Delphi сводится к тому, что сначала при помощи компонента RvProject устанавливается связь с проектом и выбирается нужный отчет, после чего при помощи RvSystem отчет выводится на печать, в файл, или на экран.

Компоненты RvCustomConnection, RvDataSetConnection, RvTableConnection и RvQueryConnection предназначены для предоставления отчету источников данных из приложения Delphi. Именно эти компоненты будут отображаться при разработке отчета в среде Rave Reports, если при создании объекта данных (New Data Object) выбрать вариант прямого просмотра данных (Direct Data View). Разумеется, при этом должна быть запущена среда Delphi с загруженным приложением, содержащим подобные компоненты.

Дата добавления: 2015-08-03